Form gönderimlerini getir

curl --request GET \
  --url https://app.azalt.co/api/v1/form-submissions \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "<string>",
    "formSiteId": "<string>",
    "organizationId": "<string>",
    "userId": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "year": 123,
    "values": [
      {
        "formElementSubmissionId": "<string>",
        "elementId": "<string>",
        "periodUnit": 123,
        "status": "COMPLETED",
        "value": "<unknown>",
        "docs": [
          "<unknown>"
        ],
        "recordedAt": "<string>"
      }
    ],
    "deletedAt": "<string>"
  }
]

FormSubmission

Form gönderimlerini getir

Form gönderimlerini esnek tanımlama seçenekleriyle döndürür.

Form Tanımlama (birini seçin):

formId: Doğrudan form kimliği (örn. “form-abc123”)
formMetadataKey + formMetadataValue: Metadata ile arama (örn. “erpFormId” = “form123”)

Opsiyonel Tesis Filtreleri:

siteId: Belirli tesis kimliği
siteMetadataKey + siteMetadataValue: Tesis metadata eşleşmesi
year: Belirli yıl

Formlar dahili ID’ler veya harici sistemlere ait metadata ile tanımlanabilir; böylece entegrasyon kolaylaşır.

Yanıt notları:

Her gönderimde values listesi bulunur; her kayıt (elementId, periodUnit) çifti içerir.
Hücrede birden çok satır varsa (ör. TIMESTAMP öğeleri veya ACTIVITY çıktı değerleri), value bir diziye dönüşür. Dizi elemanlarında:
- recordedAt (TIMESTAMP için),
- formElementSubmissionId, status, docs gibi alanlar bulunur.
Tek değerli hücrelerde value doğrudan skaler olarak gelir.

Örnek yanıt:

[
  {
    "id": "fs-1",
    "year": 2024,
    "values": [
      { "elementId": "el-monthly", "periodUnit": 3, "value": 120.5, "status": "APPROVED" },
      { "elementId": "el-ts", "periodUnit": 3, "value": [
          { "value": 10, "recordedAt": "2024-03-05T10:30:00Z", "formElementSubmissionId": "fes-1", "status": "COMPLETED", "docs": [] },
          { "value": 15, "recordedAt": "2024-03-12T08:00:00Z", "formElementSubmissionId": "fes-2", "status": "APPROVED", "docs": [] }
        ]
      }
    ]
  }
]

Bu yapı, çoklu kayıtları veya zaman damgalı verileri ayrıntılı şekilde yönetmenizi sağlar.

GET

form-submissions

Form gönderimlerini getir

curl --request GET \
  --url https://app.azalt.co/api/v1/form-submissions \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "<string>",
    "formSiteId": "<string>",
    "organizationId": "<string>",
    "userId": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "year": 123,
    "values": [
      {
        "formElementSubmissionId": "<string>",
        "elementId": "<string>",
        "periodUnit": 123,
        "status": "COMPLETED",
        "value": "<unknown>",
        "docs": [
          "<unknown>"
        ],
        "recordedAt": "<string>"
      }
    ],
    "deletedAt": "<string>"
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

formId

string

formMetadataKey

string

formMetadataValue

string

siteId

string | null

required

siteMetadataKey

string

siteMetadataValue

string

year

number | null

required

Response

Successful response

string

required

formSiteId

string

required

organizationId

string | null

required

userId

string | null

required

createdAt

string

required

updatedAt

string

required

year

number

required

values

object[]

required

Göster alt özellikler

values.formElementSubmissionId

string

required

values.elementId

string

required

values.periodUnit

number

required

values.status

enum<string>

required

Mevcut seçenekler:

COMPLETED,

APPROVED,

REJECTED

values.value

any

values.docs

any[]

values.recordedAt

string

deletedAt

string | null

required

Form öğesi gönderimlerini toplu güncelle Form gönderimini oluştur veya güncelle

⌘I

Activity

ActivityDefinition

ApiKey

Dashboard

Widget

DatasetItem

Dataset

File

Form

FormElement

FormElementSubmission

FormSubmission

FormSite

Indicator

Organization

Site

Target

Benchmark

Unit

User

Form gönderimlerini getir

Authorizations

Query Parameters

Response