01Documentation
Quatre contrats autoportants.
Un par produit. Aucun ne dépend d'une passerelle commune, aucun n'a besoin des trois autres pour répondre.
02Authentification
La clé se présente dans l'en-tête X-Cle-API. Elle est propre à un
produit : une clé d'Établissements n'ouvre pas Emplois.
curl -H "X-Cle-API: rf_…" "https://places.rankfabrik.com/villes"03Ce que porte chaque réponse
| En-tête ou champ | Signification |
|---|---|
x-appel-facture | oui ou non. Un appel sans résultat n'est jamais facturé. |
x-unites-restantes | Ce qu'il reste au quota du mois. Absent si le plan n'en a pas. |
mesures | Durée, octets collectés, unités facturées pour cet appel précis. |
completude | Part réellement renseignée de chaque champ, en pourcentage. |
motif | Renseigné quand la liste est vide. Distingue une zone sans résultat d'un refus de la source. |
truncated | Sur les balayages : la borne de temps a été atteinte avant la fin de la grille. |
04Les codes
| Code | Cause |
|---|---|
400 | Paramètre manquant ou contradictoire. Le message dit lequel. |
401 | Clé absente, inconnue ou révoquée. |
404 | Route inconnue. La réponse liste celles qui existent. |
429 | Quota épuisé. Rien n'est facturé au-delà de ce point. |
05Les quatre adresses
| Produit | Hôte | Unité facturable |
|---|---|---|
| Établissements | https://places.rankfabrik.com |
établissement rendu |
| Emplois | https://jobs.rankfabrik.com |
offre rendue |
| Transcription | https://captions.rankfabrik.com |
transcription rendue |
| Vérification | https://verify.rankfabrik.com |
adresse tranchée |
Les fichiers OpenAPI complets sont fournis sur demande à contact@rankfabrik.com, et publiés sur les places de marché où les produits sont distribués.