Vue d'ensemble API

Base URL

Sandbox (hôte public actuel) :

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

Tous les endpoints sont sous /api/v1 sauf mention contraire.

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

Service sandbox	URL
Partner Hub	https://partner.morisbox.com
Partner docs	https://docs.morisbox.com/partners
Developer docs	https://docs.morisbox.com/developers
Dev dashboard	https://partner.morisbox.com/dev/login
Application Client	https://morisbox.com

Conventions

Sujet	Règle
Format	JSON requête / JSON réponse
Auth	`Authorization: Bearer <api_key>`
Téléphones	E.164 (`+228XXXXXXXX`)
Dates	Chaînes ISO-8601
Erreurs	`{ "error": { "code", "message" } }`
Succès création	Souvent `201`

Deux surfaces d'API

Surface	Clé	Audience	Doc
Partner API	`sk_…`	Organisations partenaires	ce site (Messages, Bots…)
Developer API	`sk_dev_…`	Développeurs indépendants	docs.morisbox.com/developers

Groupes de ressources (partenaires)

Groupe	Préfixe	Doc
Messages	`/messages`	Messages
Preuve de livraison	`/messages/{id}/audit`	Sécurité et conformité
Diffusions	`/broadcasts`	Diffusions
Modèles	`/templates`	Templates
Comptes	`/accounts`	Comptes et rattachement
Conversations	`/conversations`	Conversations
Bots	`/bots`	Bots
Validation	`/validate/*`	Validation des champs
Settings	`/settings/*`	Clés, users, champs, conformité

Groupes de ressources (développeurs)

Groupe	Préfixe	Doc
Auth	`/auth/developer/*`	Developers
Profil / settings	`/dev/me`, `/dev/settings`	Developers
Clés	`/dev/api-keys`	Developers
Modèles MorisBox	`/dev/templates`	Developers
Messages	`/dev/messages`	Developers

Exemple partenaire : lister des messages

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

Exemple développeur : envoyer via modèle

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

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

Rate limits

Des limites par clé peuvent s'appliquer. En cas de throttle : 429 + hint de retry. Préférer les diffusions pour les gros volumes (partenaires).

Versioning

Version publique actuelle : v1. Les ruptures de compatibilité utiliseront un nouveau préfixe (/api/v2) ou une fenêtre de dépréciation documentée.