Идемпотентность и восстановление запросов на изображения
Идемпотентность и восстановление запросов на изображения
Перед первой отправкой создайте и сохраните уникальный 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"
}
}
}
