Milagron API Dokümantasyonu

Milagron REST API, mağaza stoklarının, fiyatlarının, ürün ve sipariş bilgilerinin programatik yönetimini sağlar. Bu dokümantasyon, entegrasyon süreçlerinde başvurulacak teknik referans niteliğindedir.

Başlangıç

1. API Anahtarı Oluşturulması

API erişimi, Milagron yönetim panelinde ilgili kullanıcı kaydının "API Yetkilendirme" bölümünden gerçekleştirilir. Anahtar oluşturulurken hangi ortam için üretileceği belirtilmelidir: Production veya Stage.

2. Ortam Seçimi

Sistem iki ayrı ortam üzerinden hizmet vermektedir:

Production

https://api.milagron.com

Canlı ortam. Yapılan tüm çağrılar sistem üzerinde gerçek değişikliklere yol açar. Anahtar formatı: mlg_…

Stage (Sandbox)

https://stageapi.milagron.com

Test ortamı. İstek doğrulamaları ve iş kuralları uygulanır; ancak sistem üzerinde herhangi bir yazma işlemi gerçekleştirilmez. Anahtar formatı: mlgs_…

3. İlk İstek

Tüm istekler HTTP Basic Authentication ile yetkilendirilmektedir. Anahtar ve gizli değer (secret), kullanıcı adı ve parola yerine geçer:

curl -u "API_KEY:API_SECRET" \
  https://api.milagron.com/health
# {"status":"ok","time":"2026-04-14T..."}

Sonraki Adımlar

Konu	Açıklama
Ortamlar	Production ve Stage ortamlarının kullanım amaçları ile davranışsal farklılıkları
Kimlik Doğrulama	Basic Authentication kullanım detayları ve dilden bağımsız örnekler
Hata Kodları	HTTP durum kodları, hata yapısı ve sıkça karşılaşılan durumlar
Rate Limits	İstek sınırlamaları ve önerilen kullanım pratikleri

API Endpoint'leri

Method	Yol	Açıklama
POST	`/integration/inventory/sellers/{sellerId}/products/stock`	Stok sorgulama
POST	`/integration/inventory/sellers/{sellerId}/products/price-and-inventory`	Stok ve fiyat güncelleme
GET	`/integration/inventory/sellers/{sellerId}/products/batch-requests/{batchId}`	Batch durum sorgulama
GET	`/integration/product/sellers/{sellerId}/products`	Ürün listesi
POST	`/integration/product/sellers/{sellerId}/products`	Ürün oluşturma
GET	`/integration/product/sellers/{sellerId}/categories`	Kategoriler
GET	`/integration/product/sellers/{sellerId}/product-types`	Ürün tipleri
GET	`/integration/product/sellers/{sellerId}/attributes`	Özellikler (attributes)
GET	`/integration/product/sellers/{sellerId}/brands`	Markalar
GET	`/integration/order/sellers/{sellerId}/orders`	Sipariş listesi
PUT	`/integration/shipment/sellers/{sellerId}/shipments`	Kargoya teslim