Vai al contenuto
AchaduDevelopers
API operativaVai al sito web
Cruscotto
Developers/API/webhook_event_schema
Webhook

Ver schema de evento

Retorna o JSON Schema e um exemplo do evento na versão atual.

GET/webhook-events/{event}/schemawebhooks:read
COMPORTAMENTO

La lettura cerca l'identificativo all'interno dell'account legato alla chiave e restituisce 404 quando non appartiene all'operazione.

EFFETTO

Non modifica le risorse né attiva la pubblicazione.

RIPETIZIONE

L'operazione è sicura da ripetere. Su 429 o 5xx, utilizzare il backoff esponenziale con jitter.

Richiesta

eventstring · pathNome completo do evento.obbligatorio
AuthorizationBearer ach_live_...
Acceptapplication/json
Ambitowebhooks:read

Esempio eseguibile

curl
curl 'https://achadu.com/api/v1/webhook-events/string/schema' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json'

Risposta ed errori

Ogni risposta include request_id. Gli elenchi aggiungono l'impaginazione; le risorse mutabili restituiscono lo stato persistente dopo l'operazione.

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"
  },
  "request_id": "req_01J..."
}
200Operazione completata.
400Parametro, corpo o transizione non validi.
401Chiave mancante, non valida, scaduta o revocata.
402Il piano dell'account non rilascia questa interfaccia.
403A chave precisa do escopo webhooks:read.
404La funzionalità non esiste in questo account.
409Lo stato attuale impedisce questa operazione.
413Il corpo JSON supera i 128 KB.
429La finestra di 120 richieste al minuto è stata superata.