Mwalikos API

Démarrage rapide

Configurez votre client en quelques étapes et testez vos premières requêtes.

Base API

URL: https://api.mwalikos.com/v1
Format: Réponses en JSON UTF-8
Version: v1 (stable)

En-têtes essentiels

Accept: application/json
Content-Type: application/json
Authorization: Bearer <token>

Cadence

Limite: 60 requêtes par minute et par jeton
Retry-After: Renvoi en secondes sur dépassement

Authentification

Utilisez des jetons personnels ou applicatifs générés via l'espace administrateur Mwalikos. Chaque requête doit inclure un jeton valide dans l'en-tête Authorization.

curl https://api.mwalikos.com/v1/programs \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Points clés

Les ressources principales couvrent la gestion des membres, des programmes et des inscriptions.

Méthode	Route	Description
GET	`/programs`	Liste paginée des programmes disponibles et de leurs statuts.
POST	`/registrations`	Crée une nouvelle inscription pour un membre à un programme.
GET	`/members/{id}`	Récupère le profil complet d'un membre.
PATCH	`/members/{id}`	Met à jour les informations d'un membre existant.
GET	`/reports/attendance`	Retourne les statistiques de présence consolidées.

Intégration en pratique

Gérez les erreurs, adaptez les webhooks et sécurisez vos intégrations en suivant les règles ci-dessous.

Gestion d'erreurs

Codes HTTP standardisés (4xx client, 5xx serveur)
Corps d'erreur contenant code, message et details

Webhooks

Recevez les événements registration.created, member.updated
Validez la signature HMAC fournie dans X-Mwalikos-Signature

Sécurité

Privilégiez l'utilisation de jetons dédiés par environnement
Renouvelez les secrets tous les 90 jours