Pular para o conteúdo
AchaduDevelopers
API operacionalIr para o site ↗
Painel →
Developers/API/webhooks_list
Webhooks

Listar webhooks

Lista destinos e eventos, nunca o segredo.

GET/webhookswebhooks:read
COMPORTAMENTO

A leitura respeita os filtros e devolve somente recursos visíveis para a conta vinculada à chave.

EFEITO

Não altera recursos nem dispara publicação.

REPETIÇÃO

A operação é segura para repetição. Em 429 ou 5xx, use backoff exponencial com jitter.

Solicitação

limitinteger · queryQuantidade por página.min 1 · max 100 · default 30opcional
offsetinteger · queryDeslocamento da paginação.min 0 · default 0opcional
AuthorizationBearer ach_live_...
Acceptapplication/json
Escopowebhooks:read

Exemplo executável

curl
curl 'https://achadu.com/api/v1/webhooks' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Resposta e erros

Toda resposta inclui request_id. Listas acrescentam pagination; recursos mutáveis retornam o estado persistido após a operação.

200 application/json
{
  "data": [
    {
      "id": "wh_01J...",
      "name": "Production",
      "url": "https://example.com/webhooks/achadu",
      "events": [
        "offer.created"
      ],
      "active": true,
      "created_at": "2026-08-31T18:20:00.000Z"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 30,
    "offset": 0,
    "has_more": false
  },
  "request_id": "req_01J..."
}
200Operação concluída.
400Parâmetro, corpo ou transição inválida.
401Chave ausente, inválida, expirada ou revogada.
402O plano da conta não libera esta interface.
403A chave precisa do escopo webhooks:read.
404Recurso inexistente nesta conta.
409O estado atual impede esta operação.
413O corpo JSON ultrapassa 128 KB.
429A janela de 120 solicitações por minuto foi excedida.