API ile Telafi Durumu Takibi

Refill talebi oluşturulduktan sonra sonucu izlemek için action=refill_status kullanılır. Tekli sorguda refill, çoklu sorguda virgülle ayrılmış refills parametresi gönderilir.

Tekli refill durumu

GET https://roketbayim.com/api/v2?key=your_api_key&action=refill_status&refill=23

{
  "refill": "23",
  "status": "completed"
}

Çoklu refill durumu

POST https://roketbayim.com/api/v2
key=your_api_key
action=refill_status
refills=21,22,23

[
  { "refill": "21", "status": "completed" },
  { "refill": "22", "status": "pending" },
  { "refill": "23", "status": "rejected" }
]

refill ve refills birlikte gönderilirse refills parametresi önceliklidir. Belirsizliği önlemek için her istekte yalnızca ihtiyacınız olan parametreyi kullanın.

Durumların anlamı

Hata yanıtları

• Refill not found: Refill ID bulunamadı.
• Unauthorized: Kayıt hesabınıza ait değil.
• Invalid refill ID: Gönderilen kimlik biçimi geçersiz.

Takip tasarımı

Refill ID, ilişkili order ID ve son sorgu zamanını birlikte saklayın. Pending durumundaki kayıtları makul aralıklarla toplu sorgulayın. Completed veya rejected olan kayıtları terminal kabul edip aktif takip kuyruğundan çıkarın.