Idempotensi dan pemulihan permintaan gambar
Idempotensi dan pemulihan permintaan gambar
Kirim Idempotency-Key yang unik pada permintaan pertama dan simpan sebelum pengiriman. Jika respons hilang, gunakan kunci idempotensi asli dan kunci API dari akun yang sama untuk menemukan permintaan tersebut. Mengulangi permintaan yang sama dengan kunci yang sama tidak menjalankan pembuatan atau penagihan lagi. Perubahan permintaan dengan kunci yang sama akan menghasilkan HTTP 409.
Pulihkan pengiriman asli
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'
Untuk permintaan asinkron, ID tugas dan tanda terima disimpan sebelum penyedia dihubungi. Setelah ID diperoleh, gunakan GET /v1/tasks/{task_id} untuk melihat status. Isi respons asli tersedia selama 10 jam sejak disimpan. Setelah kedaluwarsa, pengambilan isi mengembalikan HTTP 410 dan submission_response_expired. Waktu kedaluwarsa ada di response_expires_at. ID dan data penagihan tetap dapat dilihat pada tanda terima.
Penagihan pelanggan
Lihat data.customer_billing untuk dana yang ditahan, biaya, pengembalian dana, dan biaya bersih dalam USD. Jika final: true, nilai net_amount sudah final. Nilai null berarti nominal belum terverifikasi. Log penggunaan mencatat transaksi terkini. Pengembalian dana dapat muncul tanpa baris pemakaian yang terkait. HTTP 404 tidak memastikan apakah permintaan diterima atau apakah biayanya nol. Gunakan kunci baru untuk permintaan pengganti hanya jika tanda terima mengizinkannya. Untuk kasus lama, berikan ID permintaan atau tugas kepada tim dukungan.
{
"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"
}
}
}
