API ile Toplu Sipariş Verme ve Kısmi Başarı Yönetimi

Birden fazla siparişi tek API çağrısında oluşturmak için action=add_bulk kullanılır. RoketBayim API tek istekte en fazla 100 sipariş kabul eder. Bu yöntem ağ trafiğini azaltır ancak her siparişin sonucu ayrı değerlendirilmelidir.

JSON gövdeli örnek istek

POST https://roketbayim.com/api/v2
Content-Type: application/json

{
  "key": "your_api_key",
  "action": "add_bulk",
  "orders": [
    {
      "service": 1,
      "link": "https://instagram.com/test1",
      "quantity": 100
    },
    {
      "service": 2,
      "link": "https://instagram.com/test2",
      "quantity": 200
    }
  ]
}

Yanıt sırasını eşleme

Başarılı yanıtta her öğe için ayrı order değeri döner. Anahtarlar gönderdiğiniz listedeki sıra numarasıyla eşleşir.

{
  "0": { "order": 23501 },
  "1": { "order": 23502 }
}

Kısmi başarı ne demektir?

Toplu sipariş işlemi atomik değildir. Bazı satırlar başarılı olurken bazıları servis, miktar veya başka doğrulama hataları nedeniyle reddedilebilir.

{
  "0": { "error": "Order 1: Service not found" },
  "1": { "order": 23502 },
  "2": { "error": "Order 3: Quantity must be at least 100" }
}

Güvenilir toplu işlem akışı

Yetersiz bakiye yanıtında gereken ve kullanılabilir tutarı kontrol ederek yeni bir toplu işlem planlayın.