APIMaster.ai

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"
    }
  }
}