Conventions

Valeurs d'enum

Toutes les valeurs d'enum sont exprimées en majuscules avec des underscores (par ex. FLAT, HOUSE, NEW_MATCH), aussi bien dans les paramètres de requête que dans les réponses.

Seule exception : le type de géométrie GeoJSON (champ type), qui suit la casse exacte de la norme RFC 7946 — Point, Polygon, MultiPolygon — et est donc sensible à la casse.

Dates et fuseau horaire

Tous les formats de date et heure de l'API sont exprimés en UTC (UTC+0).

Toujours convertir une instance DateTime locale en UTC avant de l'envoyer dans une requête. Les réponses doivent également être interprétées comme UTC, puis converties dans le fuseau de l'utilisateur côté client si nécessaire.

// ✅ Correct — envoyer en UTC
const since = new Date().toISOString(); // "2026-04-29T14:32:00.000Z"

// ❌ Éviter — date locale sans conversion
const since = "2026-04-29 16:32:00";

En sortie d'API

Les dates et heures renvoyées par l'API sont au format ISO 8601 en UTC. Le décalage est indiqué soit par le suffixe Z, soit par +00:00 (équivalent) — selon le champ et l'endpoint. Quelques champs purement calendaires (dates de publication, fenêtres analytics) peuvent être renvoyés sous forme de date sans heure (YYYY-MM-DD).

{
  "createdAt": "2026-04-29T14:32:00+00:00",
  "updatedAt": "2026-04-29T15:01:42.000Z"
}

Côté client, conversion vers le fuseau utilisateur :

const localStr = new Date(item.createdAt).toLocaleString();

Voir aussi

• Limites de débit — quotas par IP et en-têtes X-RateLimit-*