Genel formu gönder

curl --request POST \
  --url https://app.azalt.co/api/v1/forms/public/{formSiteId}/submit \
  --header 'Content-Type: application/json' \
  --data '
{
  "values": [
    {
      "elementId": "<string>",
      "periodUnit": 123,
      "sequence": 123,
      "value": "<unknown>",
      "selectedUnitId": "<string>"
    }
  ],
  "submissionId": "<string>"
}
'

{
  "id": "<string>",
  "score": {
    "totalScore": 123,
    "maxPossibleScore": 123,
    "tierAchieved": {
      "id": "<string>",
      "name": "<string>",
      "minScore": 123,
      "maxScore": 123,
      "color": "<string>",
      "description": "<string>"
    },
    "sectionScores": [
      {
        "sectionId": "<string>",
        "sectionName": "<string>",
        "points": 123,
        "maxPoints": 123
      }
    ]
  }
}

Form

Genel formu gönder

Kimlik doğrulaması olmadan genel bir forma veri gönderimini sağlar.

Parametreler:

formSiteId: Form-tesis kombinasyonunun kimliği
password: Form parola korumalıysa zorunlu
values: Form öğelerine ait değerlerin listesi
submitterInfo: Gönderen kişi/kurum bilgileri (opsiyonel)

Öğe başına değer yapısı:

elementId: Form öğesi kimliği
value: Öğe tipine uygun veri değeri
periodUnit: Zaman serisi verileri için dönem (ay, çeyrek vb.)
docs: Destekleyici dosya ekleri (opsiyonel)

Doğrulamalar:

Zorunlu alanlar doldurulmalıdır
Veri tipleri öğe konfigurasyonuyla eşleşmelidir
Sayısal değerler min/max kontrollerinden geçer
Dosyalar izin verilen tür ve boyutta olmalıdır

Yaygın kullanım senaryoları:

Tedarikçi veri toplama süreçleri
Harici uyum raporlamaları
Paydaş sürdürülebilirlik anketleri
Dış tesislerden düzenli veri gönderimi

POST

forms

public

{formSiteId}

submit

Genel formu gönder

curl --request POST \
  --url https://app.azalt.co/api/v1/forms/public/{formSiteId}/submit \
  --header 'Content-Type: application/json' \
  --data '
{
  "values": [
    {
      "elementId": "<string>",
      "periodUnit": 123,
      "sequence": 123,
      "value": "<unknown>",
      "selectedUnitId": "<string>"
    }
  ],
  "submissionId": "<string>"
}
'

{
  "id": "<string>",
  "score": {
    "totalScore": 123,
    "maxPossibleScore": 123,
    "tierAchieved": {
      "id": "<string>",
      "name": "<string>",
      "minScore": 123,
      "maxScore": 123,
      "color": "<string>",
      "description": "<string>"
    },
    "sectionScores": [
      {
        "sectionId": "<string>",
        "sectionName": "<string>",
        "points": 123,
        "maxPoints": 123
      }
    ]
  }
}

Yol Parametreleri

formSiteId

string

gerekli

Gövde

application/json

values

object[]

gerekli

Show child attributes

submissionId

string

Yanıt

Successful response

string

gerekli

score

object

Show child attributes

Genel formu getir Formu getir