Documentation
Paramètres
Les paramètres de `GET /people` sont facultatifs. Les valeurs inconnues, répétées ou incompatibles sont rejetées.
Filtres disponibles
| Paramètre | Valeur | Rôle |
|---|---|---|
| count | 1–100 · défaut 1 | Nombre de profils |
| gender | male, female | Genre |
| ageGroup | child, teen, adult, senior | Un ou plusieurs groupes séparés par des virgules |
| nationality | Code ISO à deux lettres | Nationalité disposant d’un jeu de noms validé |
| residenceCountry | Code ISO à deux lettres | Pays contenant une ville disponible |
| continent | africa, americas, asia, europe, oceania | Limite les nationalités |
| city | Ville du pays de résidence | Nécessite un pays |
| emailDomain | Domaine ASCII · défaut example.test | Domaine des emails générés |
| seed | 1–128 caractères | Graine de génération |
| asOf | YYYY-MM-DD | Date de référence UTC |
| fields | Chemins séparés par des virgules | Sélection des champs renvoyés |
Groupes d’âge
Les groupes sont child (6–12 ans), teen (13–17), adult (18–64) et senior (65–100). Plusieurs valeurs distinctes peuvent être combinées : ageGroup=adult,senior.
Choisir les champs
fields sélectionne les propriétés de chaque personne. results et meta restent présents. Sans ce paramètre, tous les champs publics sont inclus sauf login, qui est facultatif.
HTTP
GET /people?fields=name.first,location.city,location.coordinates.latitude,picture.thumbnailUne combinaison parent/enfant telle que name,name.first est rejetée avec le statut 400. La query string encodée est limitée à 2 048 caractères.