Görsel isteklerinde idempotans ve kurtarma
Görsel isteklerinde idempotans ve kurtarma
İlk istekte benzersiz bir Idempotency-Key gönderin ve anahtarı göndermeden önce kaydedin. Yanıt kaybolursa özgün idempotans anahtarı ve aynı hesaba ait bir API anahtarıyla isteği sorgulayın. Aynı isteğin aynı anahtarla tekrar gönderilmesi yeniden üretim veya ücretlendirme başlatmaz. Anahtar aynı kalıp istek değişirse HTTP 409 döner.
Özgün gönderimi kurtarma
curl --fail-with-body 'https://apimaster.ai/v1/image-submissions/by-key' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Idempotency-Key: image-order-123-attempt-1'
curl --fail-with-body 'https://apimaster.ai/v1/image-submissions/by-request/REQUEST_ID' \
-H 'Authorization: Bearer YOUR_API_KEY'
curl --fail-with-body 'https://apimaster.ai/v1/image-submissions/by-key/response' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Idempotency-Key: image-order-123-attempt-1'
Eşzamansız isteklerde sağlayıcıya çağrı yapılmadan önce görev kimliği ve gönderim kaydı birlikte kaydedilir. Kimliği bulduktan sonra durumu GET /v1/tasks/{task_id} ile sorgulayın. Özgün yanıt gövdesi kaydedildikten sonra 10 saat boyunca kullanılabilir. Süre dolduğunda gövde sorgusu HTTP 410 ve submission_response_expired döndürür. Bitiş zamanını response_expires_at alanından görebilirsiniz. Görev kimliği ve ücret bilgileri kayıtta kalır.
Müşteri ücretleri
data.customer_billing alanında USD cinsinden ön provizyonu, çekilen tutarı, iadeyi ve net ücreti görebilirsiniz. final: true olduğunda net_amount kesindir. null, tutarın doğrulanamadığını belirtir. Kullanım günlüğü son işlemleri gösterir ve bazı iadelerin karşılık gelen tüketim satırı bulunmayabilir. HTTP 404, isteğin reddedildiğini veya ücretin sıfır olduğunu doğrulamaz. Yerine yeni bir istek göndermek için yalnızca kayıt açıkça izin veriyorsa yeni anahtar kullanın. Eski istekler için destek ekibine istek veya görev kimliğini iletin.
{
"data": {
"customer_billing": {
"currency": "USD",
"status": "settled",
"final": true,
"precharged_amount": "0.015876",
"charged_amount": "0.015876",
"refunded_amount": "0.000000",
"net_amount": "0.015876"
}
}
}
