Pour développeurs
API & Intégrations
Deux façons d'intégrer les données AISL en direct dans votre propre site, application ou système : une image visuelle embarquable, et une API JSON structurée pour un usage programmatique. Toutes deux publiques, sans clé d'authentification, mises en cache 1 heure.
Badge AISL Score (image SVG)
Une image générée à la volée affichant le score, la catégorie et le nom du marché — utilisable comme n'importe quelle image (<img>, Markdown, deck, email). Se met à jour automatiquement à chaque révision du score, sans action de votre part.
Endpoint
GET /api/badge/{ISO3}.svgExemple
https://aisl-web-mvp.vercel.app/api/badge/NGA.svgRemplacez NGA par n'importe quel code pays ISO 3166-1 alpha-3 (ex. KEN, ZAF, MAR). Chaque fiche pays propose un bouton copier-coller prêt à l'emploi (HTML et Markdown).
API JSON publique
Le pendant développeur du badge : les mêmes données, structurées, pour intégration programmatique dans votre propre système (scoring interne, tableau de bord, pipeline de données).
Endpoint
GET /api/public/score/{ISO3}.jsonExemple
https://aisl-web-mvp.vercel.app/api/public/score/NGA.jsonRéponse type
{
"iso3": "NGA",
"name": "Nigeria",
"region": "West Africa",
"score": {
"adjusted": 61.2,
"base": 68.0,
"category": "Open / Low Friction",
"lowConfidence": false,
"lastUpdated": "2026-08-15T10:32:00Z"
},
"market": {
"year": 2024,
"premiumsUsd": 2100000000,
"penetrationPct": 0.004,
"growthPct": 0.08,
"densityUsd": 9.4
},
"regulatoryFriction": {
"compulsoryCession": false,
"cessionBeneficiary": null,
"rightOfFirstRefusal": false,
"localCapacityRequirement": false,
"ratingMinimumRequirement": false,
"accreditationRequirement": false,
"withholdingTax": true,
"frontingSpecialAcceptance": false
},
"links": {
"profile": "https://aisl-web-mvp.vercel.app/countries/nigeria/",
"badge": "https://aisl-web-mvp.vercel.app/api/badge/NGA.svg"
},
"disclaimer": "AISL data is a decision-support tool, not legal, actuarial, regulatory or investment advice.",
"source": "AISL — Africa Insurance Signal Lab (africainsurancesignallab.com)"
}Bonnes pratiques
Mise en cache
Les deux endpoints sont mis en cache 1 heure (CDN et navigateur). Pas besoin d'implémenter votre propre cache pour un usage standard.
CORS
Les deux endpoints acceptent les requêtes cross-origin, utilisables directement depuis le navigateur d'un autre domaine.
Codes ISO
Utilisez toujours des codes ISO 3166-1 alpha-3 (3 lettres, ex. NGA, KEN, ZAF). Un code inconnu renvoie une erreur 404 explicite.
Attribution
Le champ source de la réponse JSON identifie AISL comme source — conservez cette attribution si vous réutilisez la donnée publiquement.
Besoin de plus ?
Ces deux endpoints publics couvrent un usage individuel par marché. Pour un accès plus large (export en masse, intégration approfondie, accès API étendu), contactez l'équipe AISL via la page Contact.