Skip to content

Génération d'adresses

L'endpoint /address génère une ou plusieurs adresses postales fictives pour un pays donné. Chaque adresse inclut une rue, une ville, un code postal, une région et un pays. Si aucun pays n'est spécifié, l'un d'eux est choisi aléatoirement.

Paramètres

ParamètreRequisDescription
countryNonCode pays : fr, us, uk, de ou es. Insensible à la casse. Aléatoire si omis.
countNonNombre d'adresses à générer (1–10). Par défaut : 1.

Champs de réponse

ChampTypeDescription
addressesobject[]Liste des objets d'adresse générés
addresses[].streetstringNuméro + type de voie + nom de la rue
addresses[].citystringNom de la ville
addresses[].zipstringCode postal formaté pour le pays
addresses[].statestringNom de la région ou de l'état
addresses[].countrystringNom complet du pays (ex. France, United States)
addresses[].countryCodestringCode pays en majuscules (ex. FR, US)

Pays supportés

CodePaysExemple de code postal
frFrance75001
usÉtats-Unis90210
ukRoyaume-UniAB1 2CD
deAllemagne10115
esEspagne28001

Exemples de code

curl -X GET \
  "https://api.sylvain.sh/v4/address"

Essayer

Gestion des erreurs

Message d'erreurDescription
Unknown country code "xx". Supported: fr, us, uk, de, esLe paramètre country n'est pas un code supporté
Count must be between 1 and 10Le paramètre count est hors de la plage autorisée