Tipos de webhook
Todos os tipos de webhook disponíveis estão incluídos no enum WebhookType
. Exemplos de payloads para cada um podem ser encontrados em nosso guia Tipos de Eventos.
Criando webhooks
Para criar um webhook via API:
GraphQL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation {
webhookCreate(
input: {
url: "https://example.com/webhooks/zonos"
type: ORDER_CREATED
status: ENABLED
}
) {
id
url
type
status
}
}
Editar detalhes do webhook
Para editar um webhook existente via API:
GraphQL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
mutation {
webhookUpdate(
input: {
id: "webhook-id"
url: "https://example.com/webhooks/zonos"
type: ORDER_CREATED
status: ENABLED
}
) {
id
url
type
status
}
}
Visualizar logs de webhook
Para visualizar logs de webhook via API:
GraphQL
1
2
3
4
5
6
7
8
9
10
11
12
13
query {
webhookLogs(first: 20, after: "yyyyyyy", filter: { type: ORDER_CREATED }) {
edges {
node {
id
type
url
createdAt
responseStatus
}
}
}
}
Ouça eventos com webhooks
Receba notificações de eventos em tempo real para sua integração com Zonos.
Webhooks fornecem uma maneira para Zonos notificar proativamente seus sistemas externos sempre que certos eventos ocorrerem. Quando o evento assinado ocorre, Zonos enviará uma solicitação HTTP POST para a URL do webhook que você especificar. O corpo da solicitação conterá os detalhes do evento, permitindo que seu sistema lide com o evento programaticamente.
Webhooks são úteis para integrar Zonos com outras plataformas, acionar fluxos de trabalho automatizados e manter os dados sincronizados entre sistemas em tempo real. Por exemplo, você pode usar webhooks para: