Programadores · Pedidos de aprovação
Ler a decisão de um pedido e cancelá-lo
Depois de criar um pedido, o sistema descobre a decisão lendo o pedido ou recebendo um webhook. Os webhooks são preferíveis; a leitura serve para scripts e como confirmação.
Ler o pedido
GET /v1/intents/{intent_id} com o âmbito intents:read devolve:
| Campo | Valores |
|---|---|
state | pending, approved, denied, expired, cancelled |
decidedAt | A hora da decisão |
decisionFactor | passkey, ou device para uma decisão no telemóvel |
receipt.status | awaiting_signature e depois signed |
Leia com espera crescente (por exemplo 2 segundos, a duplicar até 30) até o estado deixar de ser pending.
Cancelar
POST /v1/intents/{intent_id}/cancel retira um pedido pendente. Um pedido já decidido, expirado ou cancelado dá 409 conflict; trate-o como "já terminou" e leia o estado.
Respostas de erro
| Resposta | Causa |
|---|---|
401 | Token em falta ou expirado: peça outro |
403 insufficient_scope | O token não tem intents:read |
404 | O pedido é de outro cliente ou não existe |
409 | Estado incompatível (por exemplo, cancelar um pedido decidido) |
Antes de executar a operação
- Confirme que
stateéapproved. - Verifique o recibo assinado (ver Verificar recibos).
- Só então execute a operação no seu sistema.
Decisões e política
As decisões sobre pedidos de terceiros ainda não são avaliadas pela política de acesso da organização. Uma sessão de recuperação não pode decidir.
Códigos de erro deste artigo
Esta página ajudou?
Obrigado. A resposta fica guardada apenas neste browser; não enviamos nada.
Lamentamos. Experimente:
- pesquisar com o texto exato da mensagem ou o código de erro
- consultar o índice de códigos de erro
- falar com o administrador da sua organização