画像リクエストの冪等性と復旧
画像リクエストの冪等性と復旧
初回の送信前に一意の Idempotency-Key を作成して保存し、リクエストに付与してください。応答を受け取れなかった場合は、元の冪等キーと同じアカウントの 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'
非同期リクエストでは、プロバイダーを呼び出す前にタスク ID と送信の受領記録を一緒に保存します。ID を取得したら、GET /v1/tasks/{task_id} で状態を確認できます。元の応答本文は保存から10時間取得できます。期限後の本文取得は HTTP 410 と submission_response_expired を返します。有効期限は response_expires_at で確認できます。受領記録のタスク ID と課金情報は引き続き照会できます。
利用者の課金
data.customer_billing で仮押さえ額、請求額、返金額、差引請求額を米ドルで確認できます。final: true の場合は net_amount が確定額です。null は金額を確認できないことを示します。利用ログの対象は最近の取引で、対応する利用明細がない返金もあります。HTTP 404 だけでは受付の有無や請求額がゼロかどうかを判断できません。新しいキーでの再送は、受領記録で許可されている場合に限ってください。過去の取引は、リクエスト ID またはタスク ID をサポートにお知らせください。
{
"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"
}
}
}
