Première requête

Faire une requête

Envoyez une requête GET à l’endpoint public. Cet exemple fixe la graine et la date de référence pour pouvoir rejouer le résultat.

curl 'https://persona-dev.onrender.com/people?count=1&seed=guide-v2&asOf=2026-09-28'

Lire la réponse

La réponse contient un tableau results et un objet meta. Le nom, la date de naissance et le lieu sont structurés. Cet extrait correspond à la requête ci-dessus avec les versions de données indiquées dans meta ; il peut évoluer après une mise à jour.

{
  "results": [
    {
      "id": "per_b79c5a19b88f5f1ff40446c1",
      "gender": "male",
      "name": { "first": "Edwin", "last": "Fernández", "full": "Edwin Fernández" },
      "nationality": "PR",
      "dob": { "date": "1992-12-29", "age": 33, "ageGroup": "adult" },
      "location": { "city": "Caguas", "country": { "code": "PR", "name": "Puerto Rico" } },
      "email": "e.fernandez.3yx00@example.test",
      "phone": "+17875550116",
      "picture": { "thumbnail": "https://persona-portraits.osirisbalonga.workers.dev/portraits/v1/thumbnail/p_1166.webp" }
    }
  ],
  "meta": { "count": 1, "asOf": "2026-09-28", "seed": "guide-v2", "dataVersion": "geo-2026-09-26.1", "catalogVersion": "v1", "schemaVersion": "2" }
}

Reproduire le résultat

Fournissez explicitement seed et asOf. Les mêmes filtres produisent alors les mêmes personnes tant que les versions des données, du catalogue et de l’algorithme ne changent pas.

• count accepte de 1 à 100 profils et vaut 1 par défaut.
• seed est une chaîne non vide de 128 caractères maximum.
• asOf est une date au format YYYY-MM-DD ; sans ce paramètre, l’API utilise la date UTC du jour.