APIs et SDK

L'API 221 et ses SDK en un coup d'œil. Trouvez une route, obtenez une clé, faites un premier appel, puis choisissez un SDK.

L'API 221 publie des données de référence pour construire au Sénégal : géographie jusqu'à la commune, jours fériés, banques, préfixes d'opérateurs, annuaire des API et démarches réglementaires, plus quelques outils (jours ouvrés, montants en FCFA). Elle répond en JSON, s'appelle sans clé dans une limite quotidienne, et avec une clé gratuite au-delà.

Par où commencer

Démarrer en 5 minutes

Un appel sans inscription, puis une clé gratuite.

Authentification et clé

Créer une clé dans le tableau de bord 221 Pay, quotas avec et sans clé.

Premier appel

Un appel complet avec clé, la réponse et les erreurs, dans votre langage.

SDK 221

TypeScript, Python et Dart : installation, paiement, vérification des webhooks.

URL de base

https://apps.orvlabs.com

Le document OpenAPI 3.1 complet est servi par l'API à /v1/openapi.json.

Référence de l'API

Chaque route : paramètres, corps, réponses JSON d'exemple, erreurs, exemples d'appel en cURL, JavaScript, Python, PHP, Go, Dart, Java et C#, et un bouton « Essayer ».

Référence API 221 Pay

Paiements, liens de paiement, remboursements, retraits et soldes, avec une clé de portée payments. 49 routes

Outils

Analyser un numéro de téléphone, formater un montant en FCFA, compter des jours ouvrés. 4 routes

Référentiels

Annuaire, démarches, jeux de données, jours fériés, opérateurs, banques : listes paginées et fiches. 34 routes

Géographie

Régions, départements, arrondissements et communes, avec leurs parents et enfants. 4 routes

Comptes et webhooks

Clés API, consommation et abonnements webhooks d’un projet, depuis une session du tableau de bord. 31 routes

Signalements

Signaler une erreur de donnée, suivre son statut, trancher (mainteneurs). Répond 503 tant que le formulaire n’est pas ouvert (déclaration CDP). 2 routes

Quotas

Appel	Quota quotidien	Compté par
Sans clé	100 appels	adresse IP
Avec une clé	1 000 appels	clé

Le compteur repart à zéro à minuit GMT (heure du Sénégal). Chaque réponse comptée porte les en-têtes RateLimit-Limit, RateLimit-Remaining et RateLimit-Reset.

Erreurs

Toutes les erreurs ont la même forme : un code stable à tester dans votre code (pas le statut HTTP), un message lisible, un request_id (aussi dans l'en-tête X-Request-Id), fields quand des paramètres sont refusés, et les membres propres au code au même niveau.

Réponse 400

{
  "code": "INVALID_REQUEST",
  "message": "Paramètres invalides.",
  "request_id": "2f6c9a0e-5b1d-4e7f-8c3a-9d0b1e2f3a4c",
  "fields": { "year": "…" }
}

Statut	Code	Que faire
400	`INVALID_REQUEST`	Corriger les paramètres indiqués dans `fields`.
401	`INVALID_API_KEY`	Vérifier la clé, ou appeler sans clé.
404	`NOT_FOUND`	Vérifier l'identifiant ou le chemin.
429	`QUOTA_EXCEEDED`	Attendre `Retry-After` secondes, ou utiliser une clé.
503	`DATASET_UNAVAILABLE`	Le jeu n'est pas encore publié sur l'API.

La liste complète des codes est dans Erreurs.