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 webhooks ingress prestataires sont des routes internes de traitement. Côté intégration marchand, concentrez-vous sur les abonnements webhook sortants documentés dans Webhooks et validez toujours les signatures sur le corps 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.
Extensions boutique (WooCommerce, Magento, PrestaShop, Shopify)
Pour les extensions e‑commerce maintenues (checkout hébergé et webhooks marchands signés), voir Extensions e‑commerce.
Étapes suivantes
- Authentification — clés, hôtes, quotas, sécurité.
- Vue d’ensemble — cartographie narrative des ressources.
- Erreurs — forme des erreurs et conventions HTTP.