Autenticação - Escrybe API

Toda conta possui um securityToken pessoal. Encontre-o no painel em Minhas configurações → Acesso a API (/opcoes). Trate-o como uma senha — ele dá acesso total aos pedidos e créditos da sua conta. Existem dois estilos de autenticação, conforme o produto.

Token de API (Cartas, E-mail, Recibos)

As rotas principais de cartas e e-mail recebem o token na URL (rotas de leitura) ou como o campo de formulário userSecurityToken (rotas de criação). O header securityToken e o Authorization: Bearer funcionam nos endpoints de logo e recibos.

curl "https://app.escrybe.com.br/api/v2/balance/SEU_TOKEN"

curl "https://app.escrybe.com.br/api/v2/logo" \
  -H "securityToken: SEU_TOKEN"

curl "https://app.escrybe.com.br/api/receipts/v1/get?order_id=2607031" \
  -H "Authorization: Bearer SEU_TOKEN"

Para endpoints POST (ex.: criar um pedido ou e-mail) envie userSecurityToken como campo de formulário no corpo da requisição. Ele também é aceito como parâmetro de query onde os formatos de header funcionam.

HTTP Basic (WhatsApp)

Os endpoints de WhatsApp usam HTTP Basic Auth, onde o usuário é o e-mail da conta e a senha é o securityToken.

curl "https://app.escrybe.com.br/api/whatsapp/v1/senders/get" \
  -u "voce@exemplo.com:SEU_TOKEN"

# Authorization: Basic base64("voce@exemplo.com:SEU_TOKEN")
curl "https://app.escrybe.com.br/api/whatsapp/v1/senders/get" \
  -H "Authorization: Basic dm9jZUBleGVtcGxvLmNvbTpTRVVfVE9LRU4="

Erros

Status	Significado
`401`	Credenciais ausentes ou inválidas
`403`	Autenticado, mas sem permissão para o recurso

Veja Erros para o formato completo dos envelopes.