Formulários e Projetos

Formulários

Os formulários definem a estrutura dos seus dados de campo. Cada formulário tem um esquema versionado (JSON) que descreve seus campos.

GET /v1/forms

Listar todos os formulários na sua organização.

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

Parâmetros de consulta:

Resposta:

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

Obter um formulário individual com seu esquema publicado.

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

Resposta:

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

O array schema.fields descreve cada campo do formulário. Use os valores key como chaves de propriedades ao criar registros.

Projetos

Os projetos agrupam formulários e registros.

GET /v1/projects

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

Resposta:

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