Documentation
Réponse
La réponse version 2 contient les profils dans `results` et les informations de génération dans `meta`.
Structure JSON
| Champ | Contenu |
|---|---|
| results[].id | Identifiant synthétique |
| results[].name | first, last, full |
| results[].dob | date, age, ageGroup |
| results[].location | Adresse illustrative, ville, pays, code postal, coordonnées de ville |
| results[].email / phone | Coordonnées générées ; phone peut être null |
| results[].picture | URLs WebP large, medium, thumbnail ou null |
| meta | count, asOf, seed, schemaVersion, dataVersion, catalogVersion |
Champs parfois absents
picture vaut null si aucun portrait approuvé ne correspond. phone, street, state et postcode peuvent aussi valoir null. login est omis par défaut et n’apparaît qu’avec fields=login ou un de ses chemins enfants.
Les coordonnées ont `precision: "city" et désignent le point GeoNames de la ville, jamais l’emplacement d’une personne ou d’une rue.
Exemple minimal de lecture
JS
const response = await fetch('https://persona-dev.onrender.com/people?count=1');
if (!response.ok) throw new Error(`Persona returned ${response.status}`);
const { results, meta } = await response.json();
console.log(results[0].name.full, results[0].location.city, meta.schemaVersion);