Visão geral da API

URL base

Sandbox (host público atual):

https://api.morisbox.com/api/v1

Todos os endpoints ficam sob /api/v1, salvo indicação em contrário.

Ambiente	URL base
Sandbox	`https://api.morisbox.com/api/v1`
Docker local	`http://127.0.0.1:11300/api/v1`

Serviço do sandbox	URL
Partner Hub	https://partner.morisbox.com
Documentação para parceiros	https://docs.morisbox.com/partners
Documentação para desenvolvedores	https://developers.morisbox.com/developers
Painel do desenvolvedor	https://developers.morisbox.com/login
Application Client	https://morisbox.com

Convenções

Tema	Regra
Formato	Solicitação JSON / resposta JSON
Autenticação	`Authorization: Bearer <api_key>`
Telefones	E.164 (`+228XXXXXXXX`)
Datas	Strings ISO-8601
Erros	`{ "error": { "code", "message" } }`
Criação bem-sucedida	Normalmente `201`

Duas superfícies de API

Superfície	Chave	Público	Documentação
Partner API	`sk_…`	Organizações parceiras	este site (Mensagens, Bots…)
Developer API	`sk_dev_…`	Desenvolvedores independentes	docs.morisbox.com/developers

Grupos de recursos (parceiros)

Grupo	Prefixo	Documentação
Mensagens	`/messages`	Mensagens
Evidência de entrega	`/messages/{id}/audit`	Segurança e conformidade
Transmissões	`/broadcasts`	Transmissões
Modelos	`/templates`	Modelos
Contas	`/accounts`	Contas e vinculação
Conversas	`/conversations`	Conversas
Bots	`/bots`	Bots
Validação	`/validate/*`	Validação de campos
Configurações	`/settings/*`	Chaves, usuários, campos e conformidade

Grupos de recursos (desenvolvedores)

Grupo	Prefixo	Documentação
Autenticação	`/auth/developer/*`	Desenvolvedores
Perfil / configurações	`/dev/me`, `/dev/settings`	Desenvolvedores
Chaves	`/dev/api-keys`	Desenvolvedores
Modelos MorisBox	`/dev/templates`	Desenvolvedores
Mensagens	`/dev/messages`	Desenvolvedores

Exemplo de parceiro: listar mensagens

GET /api/v1/messages?phone=%2B228XXXXXXXX&limit=20
Authorization: Bearer sk_…

Exemplo de desenvolvedor: enviar usando um modelo

POST /api/v1/dev/messages
Authorization: Bearer sk_dev_…
Content-Type: application/json

{
  "phone": "+228XXXXXXXX",
  "template_code": "notification",
  "lang": "fr",
  "vars": { "text": "Bonjour" }
}

Limites de solicitações

Podem ser aplicados limites por chave. Em caso de throttling: 429 + indicação de nova tentativa. Prefira as transmissões para grandes volumes (parceiros).

Versionamento

Versão pública atual: v1. Alterações incompatíveis usarão um novo prefixo (/api/v2) ou um período de descontinuação documentado.