L’API

Une adresse web que vos applications interrogent pour obtenir les lieux du Togo. Chaque demande se fait avec une clé d’API, fournie par LIKSOFT à chaque application.

1. Obtenir une clé

Demandez une clé à LIKSOFT pour votre application. Gardez-la secrète : elle identifie votre application.

2. Envoyer une demande

Ajoutez la clé dans l’en-tête de chaque demande.

curl -H "Authorization: Bearer VOTRE_CLE" \
  https://geodata.liksoft.tg/v1/communes?parent=PREF_GOL_001

Les demandes possibles

`/v1`	Résumé : nombre de lieux par niveau.
`/v1/regions`	Toutes les régions.
`/v1/prefectures?parent=REG_MAR_001`	Les préfectures d’une région.
`/v1/communes?parent=PREF_GOL_001`	Les communes d’une préfecture.
`/v1/quartiers?parent=COM_GOL_002`	Les quartiers d’une commune.
`/v1/quartier/DIST_HÉD_001`	Un lieu, son adresse complète et sa position.
`/v1/search?q=hedzranawoe`	Chercher un lieu par son nom, sans se soucier des accents.
`/v1/nearest?lat=6.17&lon=1.23&level=quartier`	Les lieux les plus proches d’un point GPS.
`/v1/export`	Tout le référentiel en un seul fichier.
`/v1/outlines/region/REG_MAR_001`	Le contour d’une région ou d’une préfecture.

Exemple en JavaScript

const res = await fetch(
  "https://geodata.liksoft.tg/v1/search?q=kozah",
  { headers: { Authorization: "Bearer " + CLE } });
const { items } = await res.json();

Réponse

{ "items": [ { "level": "prefecture",
  "code": "PREF_KOZ_001", "name": "KOZAH",
  "region": "REG_KAR_001",
  "lat": 9.62, "lon": 1.25, ... } ] }

Bon à savoir

Les listes renvoient 100 lieux par défaut (500 au plus) : utilisez limit et offset pour parcourir. Chaque clé peut faire 600 demandes par minute.