Formulaires et Projets

Formulaires

Les formulaires définissent la structure de vos données terrain. Chaque formulaire possède un schéma versionné (JSON) qui décrit ses champs.

GET /v1/forms

Lister tous les formulaires de votre organisation.

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

Paramètres de requête :

Réponse :

{
  "ok": true,
  "data": [
    {
      "id": "frm_xyz",
      "type": "form",
      "project_id": "prj_456",
      "name": "Bridge Inspection",
      "description": "Standard bridge condition assessment",
      "is_active": true,
      "created_at": "2026-01-10T09:00:00Z",
      "updated_at": "2026-02-14T11:30:00Z"
    }
  ],
  "pagination": { "total": 12, "page": 1, "per_page": 50, "total_pages": 1 }
}

GET /v1/forms/:id

Obtenir un formulaire individuel avec son schéma publié.

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

Réponse :

{
  "ok": true,
  "data": {
    "id": "frm_xyz",
    "type": "form",
    "name": "Bridge Inspection",
    "description": "Standard bridge condition assessment",
    "is_active": true,
    "version": 3,
    "version_id": "fv_789",
    "schema": {
      "fields": [
        {"key": "inspector_name", "type": "text", "label": "Inspector Name", "required": true},
        {"key": "condition", "type": "single_choice", "label": "Condition", "options": ["good", "fair", "poor"]},
        {"key": "temperature", "type": "number", "label": "Temperature (C)"},
        {"key": "photo", "type": "photo", "label": "Site Photo"}
      ]
    },
    "created_at": "2026-01-10T09:00:00Z",
    "updated_at": "2026-02-14T11:30:00Z"
  }
}

Le tableau schema.fields décrit chaque champ du formulaire. Utilisez les valeurs key comme clés de propriétés lors de la création d'enregistrements.

Projets

Les projets regroupent les formulaires et les enregistrements.

GET /v1/projects

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

Réponse :

{
  "ok": true,
  "data": [
    {
      "id": "prj_456",
      "type": "project",
      "name": "Highway 101 Survey",
      "description": "Q1 2026 infrastructure assessment",
      "created_at": "2026-01-05T08:00:00Z",
      "updated_at": "2026-02-10T15:00:00Z"
    }
  ],
  "pagination": { "total": 3, "page": 1, "per_page": 50, "total_pages": 1 }
}

GET /v1/projects/:id

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