Idempotência e recuperação de solicitações de imagem
Idempotência e recuperação de solicitações de imagem
Envie um Idempotency-Key único na primeira solicitação e guarde-o antes do envio. Se perder a resposta, use a chave de idempotência original e uma chave de API da mesma conta para recuperar a solicitação. Reenviar a mesma solicitação com a mesma chave não repete a geração nem a cobrança. Alterar a solicitação e reutilizar a chave retorna HTTP 409.
Recuperar a solicitação original
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'
Nas solicitações assíncronas, o ID da tarefa e o recibo são gravados antes da chamada ao provedor. Com o ID, consulte GET /v1/tasks/{task_id} para verificar o status. O corpo da resposta original fica disponível por 10 horas após a gravação. Depois disso, a consulta do corpo retorna HTTP 410 e submission_response_expired. Consulte response_expires_at para ver a data de expiração. O ID da tarefa e a cobrança continuam disponíveis no recibo.
Cobrança do cliente
Consulte data.customer_billing para ver a reserva, a cobrança, o reembolso e o valor líquido em USD. Quando final: true, net_amount é definitivo. Um valor null indica que o valor não foi verificado. O registro de uso mostra movimentos recentes; um reembolso pode aparecer sem o lançamento de consumo correspondente. HTTP 404 não comprova que a solicitação foi rejeitada ou que a cobrança é zero. Envie uma substituição com uma nova chave apenas quando o recibo autorizar. Em casos antigos, informe o ID da solicitação ou da tarefa ao suporte.
{
"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"
}
}
}
