Listar y Filtrar Registros

GET /v1/records

Devuelve una lista paginada de registros en su organización.

Parámetros de consulta

Parámetro	Tipo	Por defecto	Descripción
`form_id`	string	--	Filtrar por ID de formulario
`project_id`	string	--	Filtrar por ID de proyecto
`since`	ISO 8601	--	Solo registros actualizados después de esta marca de tiempo
`page`	integer	1	Número de página
`per_page`	integer	50	Elementos por página (máx 500)
`include_deleted`	boolean	false	Incluir registros eliminados

Ejemplo: Listar todos los registros

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

Ejemplo: Filtrar por formulario

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

Ejemplo: Sincronización delta (cambios desde)

Obtenga solo los registros modificados desde su última sincronización:

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

Respuesta

{
  "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
  }
}

Nota: El endpoint de lista omite la geometría por rendimiento. Use GET /v1/records/:id para el registro completo con geometría, o use consultas espaciales para consultar por ubicación.

GET /v1/records/:id

Devuelve un único registro con geometría completa.

Ejemplo

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

Respuesta

{
  "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"
  }
}

Error: No encontrado

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