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>",
      "selectedUnitId": "<string>",
      "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,
      "value": "<unknown>",
      "originalValue": null,
      "selectedUnitId": "<string>",
      "userId": "<string>",
      "userName": "<string>",
      "userEmail": "<string>",
      "userImage": "<string>",
      "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>",
      "selectedUnitId": "<string>",
      "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,
      "value": "<unknown>",
      "originalValue": null,
      "selectedUnitId": "<string>",
      "userId": "<string>",
      "userName": "<string>",
      "userEmail": "<string>",
      "userImage": "<string>",
      "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

Show child attributes

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

Show child attributes

deletedAt

string | null

gerekli

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