Lister les zones

Les zones qui ont des entreprises, les plus grandes d’abord. Les valeurs du filtre zone.

GEThttps://findbytown.com/api/v1/zonesSans quota

Paramètres

Nom	Type	Description
country	string	Code pays à deux lettres, comme FR. Voir GET /countries.
locale	en \| fr \| es	Langue des libellés et des noms de catégories : en, fr ou es. Par défaut, la langue de votre compte.

Exemples

curl "https://findbytown.com/api/v1/zones?country=FR&locale=en" \
  -H "Authorization: Bearer fbt_EXAMPLE_not_a_real_key_0000"

const res = await fetch("https://findbytown.com/api/v1/zones?country=FR&locale=en", {
  headers: { Authorization: "Bearer fbt_EXAMPLE_not_a_real_key_0000" },
});
const body = await res.json();
if (!res.ok) throw new Error(body.error);
console.log(body);

import requests

res = requests.get(
    "https://findbytown.com/api/v1/zones?country=FR&locale=en",
    headers={"Authorization": "Bearer fbt_EXAMPLE_not_a_real_key_0000"},
)
body = res.json()
if not res.ok:
    raise RuntimeError(body["error"])
print(body)

Réponse

Exemple avec des valeurs fictives :

{
  "data": [
    {
      "slug": "fr_idf",
      "country": "FR",
      "level": "admin1",
      "label": "Ile-de-France",
      "count": 900
    }
  ]
}

Erreurs

Code	Statut HTTP	Signification
validation_error	400	Un paramètre est manquant ou mal formé. details indique lequel.
unknown_parameter	400	Un paramètre de requête n’est pas connu de cet endpoint, en général à cause d’une faute de frappe. details indique lequel.
use_reveal_endpoint	400	Vous avez envoyé reveal= sur une lecture. Les lectures ne consomment jamais de quota : utilisez l’endpoint de révélation.
missing_api_key	401	En-tête Authorization absent ou vide.
invalid_api_key	401	La clé n’existe pas ou a été révoquée.
plan_without_api	403	L’offre actuelle du compte n’inclut pas l’API. S’applique dès la fin d’une offre.
suspended	403	Le compte est suspendu. Ses clés refonctionnent si la suspension est levée.
rate_limited	429	Trop de requêtes cette minute. Attendez le nombre de secondes indiqué dans Retry-After.
blocked	429	L’accès aux données d’entreprises est temporairement suspendu en raison d’un usage automatisé, comme le parcours des identifiants. Retry-After indique le temps restant. Écrivez au support s’il s’agit d’une erreur.
internal_error	500	Une erreur s’est produite de notre côté. Indiquez requestId en écrivant au support.

Retour à findbytown