Form öğesi gönderimlerini içe aktar

curl --request POST \
  --url https://app.azalt.co/api/v1/form-element-submissions/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "formId": "<string>",
  "fileData": "<string>",
  "format": "csv",
  "mode": "merge",
  "fileName": "<string>",
  "mediaId": "<string>"
}
'

{
  "success": true,
  "message": "<string>",
  "stats": {
    "created": 123,
    "updated": 123,
    "deleted": 123,
    "valuesDeleted": 123,
    "formSitesCreated": 123
  }
}

FormElementSubmission

Form öğesi gönderimlerini içe aktar

Harici kaynaklardan gelen form öğesi gönderimlerini toplu olarak içe aktarır.

Özellikler:

CSV, Excel veya JSON formatlarından veri alır
Yeni kayıtlar eklenebilir veya mevcutlar güncellenebilir
Veri doğrulaması ve ayrıntılı hata raporları sunar
Form yapısıyla esnek eşleştirme destekler

TIMESTAMP desteği:

recordedAt (veya timestamp) sütunu zorunludur; ISO 8601 değeri beklenir
Yıl doğrulaması yapılır, dönem bilgisi UTC ayından türetilir
Aynı zaman damgası gönderildiğinde değer güncellenir; value boş gönderilirse replace modunda ilgili kayıt silinir, merge modunda yok sayılır

İçe aktarma modları:

merge: Dosyada bulunan değerleri günceller, dosyada olmayan değerleri değiştirmez
replace: Dosyada bulunan değerleri günceller, içe aktarılan form/tesis/yıl kapsamında dosyada olmayan değerleri temizler

Çok formlu içe aktarma:

Dosyada formName sütunu varsa, satırlar forma göre yönlendirilir; yoksa tek forma göre işlenir

Örnek yanıt:

{ "success": true, "stats": { "created": 1, "updated": 0 } }

Eski sistemlerden veri taşıma, toplu veri girişi ve otomatik senkronizasyon akışları için idealdir.

POST

form-element-submissions

import

Form öğesi gönderimlerini içe aktar

curl --request POST \
  --url https://app.azalt.co/api/v1/form-element-submissions/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "formId": "<string>",
  "fileData": "<string>",
  "format": "csv",
  "mode": "merge",
  "fileName": "<string>",
  "mediaId": "<string>"
}
'

{
  "success": true,
  "message": "<string>",
  "stats": {
    "created": 123,
    "updated": 123,
    "deleted": 123,
    "valuesDeleted": 123,
    "formSitesCreated": 123
  }
}

Yetkilendirmeler

Authorization

string

header

gerekli

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

Gövde

application/json

formId

string

gerekli

fileData

string

gerekli

format

enum<string>

varsayılan:csv

Mevcut seçenekler:

csv,

xlsx

mode

enum<string>

varsayılan:merge

Mevcut seçenekler:

merge,

replace

fileName

string

Required string length: 1 - 255

mediaId

string

Minimum string length: 1

Yanıt

Successful response

success

boolean

gerekli

message

string

gerekli

stats

object

gerekli

Show child attributes

Form öğesi gönderimlerini dışa aktar Preview form element submissions import