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>",
    "userName": "<string>",
    "userEmail": "<string>",
    "submitterName": "<string>",
    "submitterEmail": "<string>",
    "submitterTitle": "<string>",
    "submitterCompany": "<string>",
    "submitterAddress": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "year": 123,
    "values": [
      {
        "formElementSubmissionId": "<string>",
        "elementId": "<string>",
        "periodUnit": 123,
        "value": "<unknown>",
        "originalValue": null,
        "selectedUnitId": "<string>",
        "userId": "<string>",
        "userName": "<string>",
        "userEmail": "<string>",
        "userImage": "<string>",
        "docs": [
          "<unknown>"
        ],
        "comments": [
          "<unknown>"
        ],
        "recordedAt": "<string>"
      }
    ],
    "deletedAt": "<string>",
    "score": 123,
    "actionPlan": "<string>",
    "draftFiles": [
      "<unknown>"
    ],
    "scoreBreakdown": null
  }
]

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>",
    "userName": "<string>",
    "userEmail": "<string>",
    "submitterName": "<string>",
    "submitterEmail": "<string>",
    "submitterTitle": "<string>",
    "submitterCompany": "<string>",
    "submitterAddress": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>",
    "year": 123,
    "values": [
      {
        "formElementSubmissionId": "<string>",
        "elementId": "<string>",
        "periodUnit": 123,
        "value": "<unknown>",
        "originalValue": null,
        "selectedUnitId": "<string>",
        "userId": "<string>",
        "userName": "<string>",
        "userEmail": "<string>",
        "userImage": "<string>",
        "docs": [
          "<unknown>"
        ],
        "comments": [
          "<unknown>"
        ],
        "recordedAt": "<string>"
      }
    ],
    "deletedAt": "<string>",
    "score": 123,
    "actionPlan": "<string>",
    "draftFiles": [
      "<unknown>"
    ],
    "scoreBreakdown": null
  }
]

Yetkilendirmeler

Authorization

string

header

gerekli

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

Sorgu Parametreleri

formId

string

formMetadataKey

string

formMetadataValue

string

siteId

string | null

gerekli

siteMetadataKey

string

siteMetadataValue

string

year

number | null

gerekli

Yanıt

Successful response

string

gerekli

formSiteId

string

gerekli

organizationId

string | null

gerekli

userId

string | null

gerekli

userName

string | null

gerekli

userEmail

string | null

gerekli

submitterName

string | null

gerekli

submitterEmail

string | null

gerekli

submitterTitle

string | null

gerekli

submitterCompany

string | null

gerekli

submitterAddress

string | null

gerekli

createdAt

string

gerekli

updatedAt

string

gerekli

year

number

gerekli

values

object[]

gerekli

Show child attributes

deletedAt

string | null

gerekli

score

number | null

gerekli

actionPlan

string | null

gerekli

draftFiles

any[]

scoreBreakdown

unknown

Form-tesis ilişkisi oluştur Form gönderimini oluştur veya güncelle