APIMaster.ai

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