APIMaster.ai

Идемпотентность и восстановление запросов на изображения

Идемпотентность и восстановление запросов на изображения

Перед первой отправкой создайте и сохраните уникальный Idempotency-Key. Если ответ потерян, найдите запрос по исходному ключу идемпотентности с API-ключом того же аккаунта. Повторная отправка того же запроса с тем же ключом не приводит к повторной генерации или списанию. Если изменить запрос и оставить тот же ключ, API вернёт HTTP 409.

Как восстановить исходный запрос

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'

При асинхронной отправке идентификатор задания и квитанция сохраняются до обращения к поставщику. После восстановления идентификатора проверяйте статус через GET /v1/tasks/{task_id}. Тело исходного ответа доступно 10 часов с момента сохранения. После этого запрос тела вернёт HTTP 410 и submission_response_expired. Время истечения указано в response_expires_at. Идентификатор и расчётные данные остаются доступны в квитанции.

Расчёт с клиентом

В data.customer_billing указаны резерв, списание, возврат и итоговая сумма в долларах США. При final: true значение net_amount окончательное. Значение null означает, что сумму не удалось подтвердить. Журнал использования показывает недавние операции. В нём возможна запись о возврате без соответствующей строки расхода. HTTP 404 не подтверждает ни отказ в приёме, ни отсутствие списания. Отправляйте замену с новым ключом только при явном разрешении в квитанции. Для старого запроса передайте поддержке идентификатор запроса или задания.

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