Rascunho
Autenticação
Chaves de API, escopos, modos de teste e produção.
Chaves de API
Envie sua chave como bearer token:
GET /v1/me HTTP/1.1
Host: api.wagend.app
Authorization: Bearer wg_live_3fa9c2_Lr8t...
| Prefixo | Modo |
|---|---|
wg_live_ | Dados de produção, mensagens e pagamentos reais |
wg_test_ | Sandbox: dados isolados, nenhuma mensagem enviada, pagamentos simulados |
As chaves pertencem a um workspace. O workspace sempre é tirado da chave: não existe id de workspace em paths nem em corpos. As chaves são guardadas com hash; a chave completa aparece só uma vez, na criação.
Escopos
| Escopo | Permite |
|---|---|
slots:read | GET /slots |
bookings:read | Listar e ler agendamentos |
bookings:write | Pré-reservas, confirmar, cancelar, reagendar, check-in, falta |
customers:read | Ler clientes |
messages:read | Ler conversas e mensagens |
messages:write | Enviar mensagens, transferir |
config:read / config:write | Serviços, recursos, grupos, horários, automações, conhecimento |
webhooks:manage | Endpoints de webhook |
Uma requisição sem o escopo necessário devolve 403 com code: "insufficient_scope".
Rotação
Crie uma chave nova, publique, e depois revogue a antiga em Desenvolvedores → Chaves de API. Chaves revogadas devolvem 401 na hora.