Quickstart

Faites votre premier appel à l'API trippier en moins de deux minutes.

1. Récupérez l'API

Deux options, même schéma de routes :

  • Cloud : créez un compte, récupérez votre clé API depuis le dashboard, 1 000 tokens offerts.
  • Self-hosted : une image Docker, vos serveurs, démarrez avec POI_AUTH_DISABLED=true pour désactiver l'auth.

2. Premier appel (sans auth)

GET /health est la seule route ouverte : aucun token, aucune authentification.

bash 
curl https://api.poi.trippier.dev/health

3. Appel authentifié

Pour toutes les autres routes, passez votre clé via l'en-tête X-API-Key :

bash 
curl "https://api.poi.trippier.dev/pois/search?lat=45.76&lng=4.83&radius=1500" \
  -H "X-API-Key: YOUR_API_KEY"
Route gratuite. Seul GET /health est publique et ne consomme aucun token. Les routes /pois/providers* coûtent 1 token chacune.