Serviços para a sua aplicação

CLAUDO Queues

Filas e agendamentos por HTTP: a CLAUDO chama a sua aplicação, assinado e com novas tentativas.

Ligar

Em Queues, Criar chave e, em Chave de assinatura, gere a chave. Escolhendo um projeto, CLAUDO_QUEUES_URL, CLAUDO_QUEUES_TOKEN e CLAUDO_QUEUES_SIGNING_KEY vão para Production.

Mandar uma mensagem

curl -X POST "$CLAUDO_QUEUES_URL/messages" \
  -H "Authorization: Bearer $CLAUDO_QUEUES_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://loja.com.br/api/jobs/enviar-nota",
    "body": { "pedido": 123 },
    "delay_seconds": 60,
    "queue": "notas"
  }'

Campo	Detalhe
`url`	https, endereço público
`method`	POST (padrão), GET, PUT, PATCH ou DELETE
`body`, `content_type`, `headers`	corpo até 1 MB; até 20 cabeçalhos
`delay_seconds` ou `deliver_at`	quando entregar, até 7 dias à frente
`retries`	de 0 a 10 (padrão 3)
`queue`	mensagens da mesma fila saem uma de cada vez, na ordem
`deduplication_id`	a mesma não entra duas vezes

Agendamentos: POST /schedules com os mesmos campos e cron (5 campos, horário UTC, no máximo uma vez por minuto). GET /messages/<id> mostra a última resposta; POST /messages/<id>/retry tenta de novo uma que falhou.

Receber e conferir

A CLAUDO chama a sua url com o corpo e os cabeçalhos que você mandou, mais Claudo-Message-Id, Claudo-Retried (quantas tentativas antes), Claudo-Queue, Claudo-Schedule-Id e Claudo-Signature: t=<unix>,v1=<hex>. O v1 é o HMAC-SHA256 de <t>.<corpo> com CLAUDO_QUEUES_SIGNING_KEY (o código dos webhooks serve). Por 24 horas depois de trocar a chave, vão dois v1: aceite se qualquer um conferir.

Responda 2xx em até 30 segundos. Sem isso, novas tentativas em 10 s, 30 s, 2 min, 10 min, 30 min e assim por diante, até 24 h.
Esgotadas as tentativas, a mensagem falha e dispara queue.failed.
Mensagens no mês: Free 10.000, Pro 500.000, Scale 5.000.000.