Une fois la clé obtenue
Trois choses à savoir
Header HTTP
X-API-Key: nh_a1b2c3d4e5f6...
Toutes les requêtes vers /api/v2/* doivent inclure ce header. Le query string ?api_key= reste accepté pour les tests rapides.
Exemple curl
curl -s https://www.nexthop.fr/api/v2/providers \ -H 'X-API-Key: nh_xxxxxxxx...'
Réponse JSON paginée, jusqu'à 1000 providers par appel pour les clés authentifiées.
Suivi quota
GET /api/v2/usage
Renvoie en temps réel le tier, le rate-limit, le quota mensuel restant. Pratique pour déclencher un fallback au-delà de 80 pour cent.
Besoin d'une clé Pro ou Enterprise ?
Quotas élevés (100 000 à 1M req/mois), support prioritaire, SLA contractuel.