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

Authorizations

Authorization

string

header

required

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

Body

application/json

year

number

required

values

object[]

required

Göster alt özellikler

values.periodUnit

number

required

values.elementId

string

values.elementKey

string

values.elementMetadataKey

string

values.elementMetadataValue

string

values.value

any

values.timestamp

formId

string

formMetadataKey

string

formMetadataValue

string

siteId

string

siteMetadataKey

string

siteMetadataValue

string

Response

Successful response

string

required

createdAt

string

required

updatedAt

string

required

formSiteId

string

required

userId

string | null

required

organizationId

string | null

required

values

object[]

required

Göster alt özellikler

values.formElementSubmissionId

string | null

required

values.elementId

string

required

values.periodUnit

number

required

values.status

enum<string> | null

required

Mevcut seçenekler:

COMPLETED,

APPROVED,

REJECTED,

values.value

any

values.recordedAt

string | null

deletedAt

string | null

required

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

⌘I

Activity

ActivityDefinition

ApiKey

Dashboard

Widget

DatasetItem

Dataset

File

Form

FormElement

FormElementSubmission

FormSubmission

FormSite

Indicator

Organization

Site

Target

Benchmark

Unit

User

Form gönderimini oluştur veya güncelle

Authorizations

Body

Response