Lister et Filtrer les Enregistrements

GET /v1/records

Retourne une liste paginée des enregistrements de votre organisation.

Paramètres de requête

Paramètre	Type	Par défaut	Description
`form_id`	string	--	Filtrer par ID de formulaire
`project_id`	string	--	Filtrer par ID de projet
`since`	ISO 8601	--	Uniquement les enregistrements mis à jour après ce timestamp
`page`	integer	1	Numéro de page
`per_page`	integer	50	Éléments par page (max 500)
`include_deleted`	boolean	false	Inclure les enregistrements supprimés

Exemple : Lister tous les enregistrements

curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/records"

Exemple : Filtrer par formulaire

curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/records?form_id=frm_abc123"

Exemple : Synchronisation delta (changements depuis)

Récupérez uniquement les enregistrements modifiés depuis votre dernière synchronisation :

curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/records?since=2026-02-15T00:00:00Z"

Réponse

{
  "ok": true,
  "data": [
    {
      "id": "rec_abc123",
      "type": "record",
      "form_id": "frm_xyz",
      "project_id": "prj_456",
      "form_version_id": "fv_789",
      "properties": {
        "inspector_name": "Jane Smith",
        "condition": "good",
        "notes": "All systems operational"
      },
      "geometry": null,
      "created_by": "user_id",
      "updated_by": "user_id",
      "created_at": "2026-02-15T14:30:00Z",
      "updated_at": "2026-02-15T16:45:00Z",
      "status": "active",
      "assigned_to": null,
      "workflow_state_id": null,
      "priority": null
    }
  ],
  "pagination": {
    "total": 1250,
    "page": 1,
    "per_page": 50,
    "total_pages": 25
  }
}

Note : L'endpoint de liste omet la géométrie pour les performances. Utilisez GET /v1/records/:id pour l'enregistrement complet avec géométrie, ou utilisez les requêtes spatiales pour interroger par localisation.

GET /v1/records/:id

Retourne un enregistrement unique avec la géométrie complète.

Exemple

curl -H "X-API-Key: mk_live_..." \
  "https://<ref>.supabase.co/functions/v1/api-gateway/v1/records/rec_abc123"

Réponse

{
  "ok": true,
  "data": {
    "id": "rec_abc123",
    "type": "record",
    "form_id": "frm_xyz",
    "project_id": "prj_456",
    "properties": { "inspector_name": "Jane Smith" },
    "geometry": {
      "type": "Point",
      "coordinates": [-73.985, 40.758]
    },
    "created_at": "2026-02-15T14:30:00Z",
    "updated_at": "2026-02-15T16:45:00Z",
    "status": "active"
  }
}

Erreur : Non trouvé

{
  "ok": false,
  "error": {
    "code": "not_found",
    "message": "Record rec_abc123 not found."
  }
}