Form gönderimini oluştur veya güncelle

curl --request POST \
  --url https://app.azalt.co/api/v1/form-submissions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "year": 123,
  "values": [
    {
      "periodUnit": 123,
      "elementId": "<string>",
      "elementKey": "<string>",
      "elementMetadataKey": "<string>",
      "elementMetadataValue": "<string>",
      "value": "<unknown>",
      "timestamp": "<string>"
    }
  ],
  "formId": "<string>",
  "formMetadataKey": "<string>",
  "formMetadataValue": "<string>",
  "siteId": "<string>",
  "siteMetadataKey": "<string>",
  "siteMetadataValue": "<string>"
}
'

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

FormSubmission

Form gönderimini oluştur veya güncelle

Form gönderimlerini oluşturur veya günceller; form, tesis ve öğeler esnek biçimde tanımlanabilir.

Form Tanımlama (birini seçin):

formId: Form kimliği
formMetadataKey + formMetadataValue: Metadata ile arama

Tesis Tanımlama (birini seçin):

siteId: Tesis kimliği
siteMetadataKey + siteMetadataValue: Metadata ile arama

Form Öğesi Tanımlama (her değer için birini seçin):

elementId: Öğenin kimliği
elementKey: Form içindeki öğe anahtarı
elementMetadataKey + elementMetadataValue: Metadata ile arama

TIMESTAMP öğeleri:

values[].timestamp (ISO 8601) zorunludur; sunucu UTC aya göre periodUnit türetir ve yıl eşleşmesini kontrol eder.
Aynı zaman damgası gönderildiğinde mevcut kayıt güncellenir; silmek için value: null gönderin.

Örnek istek:

{
  "formId": "form-123",
  "siteId": "site-1",
  "year": 2024,
  "values": [
    { "elementId": "el-ts", "value": 42, "timestamp": "2024-03-15T10:30:00Z", "periodUnit": 3 }
  ]
}

Örnek yanıt:

{
  "id": "fs-1",
  "formSiteId": "fs-site-1",
  "values": [
    { "elementId": "el-ts", "periodUnit": 3, "value": 42, "recordedAt": "2024-03-15T10:30:00.000Z" }
  ]
}

Harici sistemlerin kendi kimlikleriyle entegrasyonuna izin verirken dahili ID’leri de destekler.

POST

form-submissions

Form gönderimini oluştur veya güncelle

curl --request POST \
  --url https://app.azalt.co/api/v1/form-submissions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "year": 123,
  "values": [
    {
      "periodUnit": 123,
      "elementId": "<string>",
      "elementKey": "<string>",
      "elementMetadataKey": "<string>",
      "elementMetadataValue": "<string>",
      "value": "<unknown>",
      "timestamp": "<string>"
    }
  ],
  "formId": "<string>",
  "formMetadataKey": "<string>",
  "formMetadataValue": "<string>",
  "siteId": "<string>",
  "siteMetadataKey": "<string>",
  "siteMetadataValue": "<string>"
}
'

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

Yetkilendirmeler

Authorization

string

header

gerekli

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

Gövde

application/json

year

number

gerekli

values

object[]

gerekli

Göster alt özellikler

formId

string

formMetadataKey

string

formMetadataValue

string

siteId

string

siteMetadataKey

string

siteMetadataValue

string

Yanıt

Successful response

string

gerekli

createdAt

string

gerekli

updatedAt

string

gerekli

formSiteId

string

gerekli

userId

string | null

gerekli

organizationId

string | null

gerekli

values

object[]

gerekli

Göster alt özellikler

deletedAt

string | null

gerekli

Form gönderimlerini getir Form gönderim sayılarını getir

Activity

ActivityDefinition

ApiKey

Benchmark

Cron Jobs

Dashboard

DatasetItem

Dataset

File

FormElement

FormElementSubmission

FormSite

FormSubmission

Form

Import

Indicator

Organization

Site

Target

Unit

User

Widget

Form gönderimini oluştur veya güncelle

Yetkilendirmeler

Gövde

Yanıt