APIMaster.ai

Idempotenz und Wiederherstellung von Bildaufträgen

Idempotenz und Wiederherstellung von Bildaufträgen

Senden Sie beim ersten Bildauftrag einen eindeutigen Idempotency-Key und speichern Sie ihn vor dem Versand. Geht die Antwort verloren, können Sie den Auftrag mit einem API-Schlüssel desselben Kontos und dem ursprünglichen Schlüssel abrufen. Derselbe Schlüssel und derselbe unveränderte Auftrag werden nur einmal ausgeführt und abgerechnet. Ein geänderter Auftrag mit demselben Schlüssel führt zu HTTP 409.

Ursprünglichen Auftrag wiederherstellen

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'

Bei asynchronen Bildaufträgen werden die Auftrags-ID und der Übermittlungsbeleg gespeichert, bevor der Anbieter aufgerufen wird. Fragen Sie bei bekannter ID den Status über GET /v1/tasks/{task_id} ab. Der ursprüngliche Antwortinhalt bleibt ab seiner Speicherung 10 Stunden verfügbar. Nach Ablauf liefert der Abruf des Inhalts HTTP 410 mit submission_response_expired; response_expires_at enthält den Ablaufzeitpunkt. Auftrags-ID und Abrechnung bleiben im Beleg abrufbar.

Kundenabrechnung

Prüfen Sie data.customer_billing für den reservierten, abgebuchten und erstatteten Betrag sowie den Nettobetrag in USD. Mit final: true ist net_amount endgültig; null bedeutet, dass der Betrag nicht verifiziert werden konnte. Das Nutzungsprotokoll zeigt jüngere Buchungen. Eine Erstattung kann ohne zugehörigen Verbrauchseintrag erscheinen. HTTP 404 bestätigt weder die Nichtannahme noch einen Betrag von null. Einen Ersatzauftrag mit einem neuen Schlüssel sollten Sie erst absenden, wenn der Beleg dies ausdrücklich erlaubt. Geben Sie dem Support bei älteren Fällen die Auftrags- oder Anfrage-ID weiter.

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