Ortamlar

Milagron API'nin iki ortamı vardır: canlı ortam ve test ortamı. Test ortamı henüz açık değildir, bu yüzden entegrasyonunuzu şimdilik canlı ortamda geliştirmeniz gerekir.

Canlı (Production)

https://api.milagron.com

Yaptığınız her istek kalıcı sonuç doğurur.

Test (Stage)

Yakında

Henüz açılmadı. Bu sayfadaki test ortamı davranışları, ortam açıldığında geçerli olacak tasarımı anlatır.

Canlı Ortamda Geliştirme

Test ortamı açılana kadar aşağıdaki sıra, canlı veriye zarar vermeden ilerlemenizi sağlar.

1. Salt okunur uçlarla başlayın

Katalog ve listeleme uçlarının hiçbir yan etkisi yoktur, istediğiniz kadar çağırabilirsiniz: /brands, /categories, /product-types, /categories/{id}/attributes, /attributes, /products, /orders ve POST .../products/stock. ID keşif zincirini bu aşamada oturtun.

2. Hata akışlarını doğrulama hatalarıyla deneyin

Bir yazma ucuna bilerek geçersiz gövde göndermek hiçbir kayıt oluşturmaz, istek doğrulama aşamasında reddedilir. Örneğin 256 karakterlik bir title göndererek 422 işleyişinizi, var olan bir barkodu göndererek 409 işleyişinizi güvenle sınayabilirsiniz.

3. Yazma uçlarına kontrollü geçin

Oluşturduğunuz ürünler taslak olarak kalır ve onaydan geçmeden satışa çıkmaz.
Test ürünlerinizin barkod ve stok kodlarına tanınabilir bir ön ek verin (örneğin TEST-) ki sonradan bulup temizleyebilesiniz.
Stok ve fiyat güncellemelerini önce tek kalemlik isteklerle deneyin.

Kargoya teslim ucu geri alınamaz. Kargoya teslim ucu gerçek siparişi kargoya verilmiş olarak işaretler ve müşteriye bildirim gönderir. Bu ucu yalnızca gerçekten kargoya vereceğiniz siparişlerde çağırın.

İki Ortam Arasındaki Farklar

Davranış	Canlı	Test
Kimlik doğrulama	Uygulanır	Uygulanır
İstek limitleri	Uygulanır	Uygulanır
Alan doğrulaması	Uygulanır	Uygulanır
İş kuralları (örneğin salePrice ≤ listPrice)	Uygulanır	Uygulanır
Barkod ve sipariş eşleştirme	Uygulanır	Uygulanır
Veritabanına yazma	Yapılır	Yapılmaz
Dış sistem entegrasyonları	Yapılır	Yapılmaz
Okuma uçları	Gerçek veri döner	Gerçek veri döner
Toplu işlem oluşturma	Yapılır	Yapılır (ortam etiketiyle)
Toplu işlem durumu	Gerçek sonuç	Örnek sonuç

Anahtar Biçimi

API anahtarının ön eki, hangi ortama ait olduğunu belirtir:

Ön ek	Ortam	Örnek
`mlg_`	Canlı	`mlg_a3f7b8c2…`
`mlgs_`	Test	`mlgs_4e5d6a1b…`

Her anahtar yalnızca kendi ortamında geçerlidir. Yanlış sunucuya yapılan istekler 401 ile reddedilir. Test ortamı henüz açılmadığı için şu anda yalnızca mlg_ ön ekli canlı ortam anahtarları veriyoruz.

Hata Senaryolarını Deneme

Bu özellik test ortamı açıldığında kullanılabilir olacak. X-Stage-Force-Error başlığı canlı ortamda bilinçli olarak yok sayılır; aksi hâlde canlı ortamda sahte hatalar ürettirilebilir ve gerçek davranış gizlenirdi. Bu başlığı canlı ortama göndermek yanıtı etkilemez.

Test ortamı açıldığında hata yönetiminizi şöyle sınayabileceksiniz:

curl -u "API_KEY:API_SECRET" \
  -H "X-Stage-Force-Error: rate_limit" \
  -X POST https://stageapi.milagron.com/integration/inventory/sellers/123/products/stock \
  -d '{"barcode":"ABC"}'
# HTTP 429 Simulated rate limit exceeded

Başlık değeri	Üretilen hata
`rate_limit`	429 TooManyRequests
`unauthorized`	401 Unauthorized
`forbidden`	403 Forbidden
`not_found`	404 NotFound
`validation`	422 ValidationError
`server_error`	500 InternalError

Test ortamı açıldığında bu sayfa güncellenecek ve size ayrıca haber verilecektir.