Idempotencja i odzyskiwanie żądań obrazów
Idempotencja i odzyskiwanie żądań obrazów
Przy pierwszym wysłaniu użyj unikatowego nagłówka Idempotency-Key i zapisz jego wartość przed wysłaniem. Gdy odpowiedź zaginie, użyj pierwotnego klucza idempotencji i klucza API z tego samego konta. Ponowne wysłanie identycznego żądania z tym samym kluczem nie powoduje kolejnej generacji ani obciążenia. Zmiana treści żądania przy tym samym kluczu skutkuje odpowiedzią HTTP 409.
Odzyskiwanie pierwotnego żądania
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'
Dla żądań asynchronicznych identyfikator zadania i potwierdzenie zapisywane są przed wywołaniem dostawcy. Po odzyskaniu identyfikatora stan zadania sprawdzisz przez GET /v1/tasks/{task_id}. Treść pierwotnej odpowiedzi jest dostępna przez 10 godzin od zapisu. Później pobranie treści zwraca HTTP 410 i submission_response_expired. Czas wygaśnięcia określa response_expires_at. Identyfikator zadania i rozliczenie nadal są dostępne w potwierdzeniu.
Rozliczenie klienta
W data.customer_billing znajdziesz kwotę rezerwacji, obciążenie, zwrot i kwotę netto w USD. Gdy final: true, net_amount jest ostateczną kwotą. Wartość null oznacza kwotę niezweryfikowaną. Dziennik użycia pokazuje ostatnie operacje; wpis refundacji może nie mieć odpowiadającego mu wpisu zużycia. Odpowiedź HTTP 404 nie przesądza o przyjęciu żądania ani o braku obciążenia. Użyj nowego klucza do wysłania żądania zastępczego tylko wtedy, gdy potwierdzenie wyraźnie na to pozwala. Przy starszych sprawach podaj pomocy technicznej identyfikator żądania lub zadania.
{
"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"
}
}
}
