Descripción general de la API

URL base

Sandbox (host público actual):

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

Todos los endpoints están bajo /api/v1, salvo que se indique lo contrario.

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

Servicio del sandbox	URL
Partner Hub	https://partner.morisbox.com
Documentación para socios	https://docs.morisbox.com/partners
Documentación para desarrolladores	https://developers.morisbox.com/developers
Panel de desarrollador	https://developers.morisbox.com/login
Aplicación cliente	https://morisbox.com

Convenciones

Tema	Regla
Formato	Solicitud JSON / respuesta JSON
Autenticación	`Authorization: Bearer <api_key>`
Teléfonos	E.164 (`+228XXXXXXXX`)
Fechas	Cadenas ISO-8601
Errores	`{ "error": { "code", "message" } }`
Creación correcta	Normalmente `201`

Dos superficies de API

Superficie	Clave	Público	Documentación
Partner API	`sk_…`	Organizaciones asociadas	este sitio (Mensajes, Bots…)
Developer API	`sk_dev_…`	Desarrolladores independientes	docs.morisbox.com/developers

Grupos de recursos (socios)

Grupo	Prefijo	Documentación
Mensajes	`/messages`	Mensajes
Prueba de entrega	`/messages/{id}/audit`	Seguridad y cumplimiento
Difusiones	`/broadcasts`	Difusiones
Plantillas	`/templates`	Plantillas
Cuentas	`/accounts`	Cuentas y vinculación
Conversaciones	`/conversations`	Conversaciones
Bots	`/bots`	Bots
Validación	`/validate/*`	Validación de campos
Ajustes	`/settings/*`	Claves, usuarios, campos y cumplimiento

Grupos de recursos (desarrolladores)

Grupo	Prefijo	Documentación
Autenticación	`/auth/developer/*`	Desarrolladores
Perfil / ajustes	`/dev/me`, `/dev/settings`	Desarrolladores
Claves	`/dev/api-keys`	Desarrolladores
Plantillas de MorisBox	`/dev/templates`	Desarrolladores
Mensajes	`/dev/messages`	Desarrolladores

Ejemplo de socio: enumerar mensajes

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

Ejemplo de desarrollador: enviar mediante una plantilla

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

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

Límites de solicitudes

Pueden aplicarse límites por clave. En caso de throttling: 429 + indicación de reintento. Prefiera las difusiones para grandes volúmenes (socios).

Versionado

Versión pública actual: v1. Los cambios incompatibles utilizarán un nuevo prefijo (/api/v2) o un periodo de obsolescencia documentado.