API de Integração
Webhooks legado

Alterar preferência de webhook

Altera um endpoint de webhook: URL, situação, eventos e cursos. Envie só os campos que quer mudar. Sistema antigo de webhooks: para novas integrações use as rotas de **Webhooks** (`/webhooks`).

Descontinuado

PATCH
/webhook/preference

Autorização

apiToken
Api-Token<token>

Token do parceiro. Gere no painel do parceiro: Configurações > Integrações > API Token (perfil Admin ou Superadmin). Envie só este header: se Authorization também for enviado, ele tem prioridade e a requisição é recusada com 401.

Local: header

Corpo da Requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

Corpo da Resposta

application/json

application/json

curl -X PATCH "https://example.com/webhook/preference" \  -H "Content-Type: application/json" \  -d '{    "id": 123,    "enabledEvents": [      "made_effective"    ]  }'
{  "message": "Endpoint updated",  "data": {    "id": 123,    "url": "https://www.example.com/slug",    "status": "enabled",    "enabledEvents": [      "made_effective"    ],    "enabledCourses": [      "*"    ]  }}

Criar preferência de webhook

Cadastra um endpoint de webhook. Sem `enabledEvents` ou `enabledCourses`, vale `*` (todos). Sistema antigo de webhooks: para novas integrações use as rotas de **Webhooks** (`/webhooks`).

Regenerar assinatura

Gera uma nova assinatura, enviada nos headers dos webhooks. Sistema antigo de webhooks: para novas integrações use as rotas de **Webhooks** (`/webhooks`).