Intégration API
Parcours complet du premier appel HTTP authentifié jusqu’aux exemples de langage, Try it, SDK et webhooks.
Point d’entrée unique pour une intégration de qualité production avec l’API REST lomi..
URL de base et première requête
Utilisez Test en construisant ; ne changez clés et hôte qu’au passage en production.
| Environnement | Base URL | Clés API |
|---|---|---|
| Test | https://sandbox.api.lomi.africa | lomi_sk_test_… |
| Live | https://api.lomi.africa | lomi_sk_live_… |
Envoyez la clé secrète sur chaque requête via X-API-Key (en-tête insensible à la casse). Lecture minimale commune aux deux environnements : GET /accounts :
curl -sS \
-H "X-API-Key: $LOMI_API_KEY" \
"https://sandbox.api.lomi.africa/accounts"Utilisez une clé secrète du tableau de bord (Developers / API), préfixes lomi_sk_test_… ou lomi_sk_live_…. Jamais depuis un navigateur ou client mobile léger. Détail environnements et hygiène des clés : Authentification.
Référence HTTP complète (API)
Liste canonique des chemins, méthodes, paramètres, sécurité et corps : site API généré.
- Index de la référence API — opérations, onglets par langage (cURL, JavaScript, Go, Python, Java, C#) et bac à sable Try it.
Le bac à sable passe par le proxy de la doc (/api/proxy dans cette app), utile pour explorer sans CORS ; en production, appelez l’API depuis vos serveurs.
SDK vs HTTP brut
| Approche | Usage | Documentation |
|---|---|---|
| HTTP brut | Contrôle maximal, tout stack | Ce hub + référence API |
| SDK officiels / communauté | Intégration plus rapide quand le client convient | Vue SDK et pages langage |
Les SDK respectent les mêmes URL de base, en-têtes et JSON que l’HTTP brut.
Webhooks (HTTP entrant vers votre serveur)
Votre point de terminaison reçoit du JSON brut. Pour la signature, utilisez les octets exacts reçus : pas de JSON reformaté, qui peut casser les schémas HMAC.
Les routes ingress des prestataires (Wave, type Stripe…) figurent sous les chemins webhook de l’arbre API. URL configurées dans le tableau de bord ; vérifiez les signatures comme documenté avec le tampon brut.
Pour vos abonnements webhook sortants (liste, détail, mise à jour) via l’API marchand : Webhooks et opérations homonymes dans la référence API.
Étapes suivantes
- Authentification — clés, hôtes, quotas, sécurité.
- Vue d’ensemble — cartographie narrative des ressources.
- Erreurs — forme des erreurs et conventions HTTP.