forms — Web (Site Kurucu) API

POST/api/web/public/v1/forms/{id}/submit

`POST /api/web/public/v1/forms/{id}/submit` — headless form gönderimi

API anahtarıYol parametresi: id

(BLE2-13578). # 🔴 Neden ZİYARETÇİ ucunun İKİZİ DEĞİL `POST /_web/form/{id}` JS'siz bir tarayıcı için tasarlandı: bal küpü, **imzalı zaman damgası** ve IP hız sınırı taşır. Headless bir istemci formumuzu ÇİZMEZ — elinde damga yoktur ve o kapıdan asla geçemez. Burada güven modeli farklıdır: kimlik **API anahtarıdır** ve sınır anahtar başınadır. Yani bu, aynı işin ikinci yolu değil, BAŞKA bir kapının kendi yoludur. ⚠ Kapsam `web.forms.submit`tir ve gelen kutusunu OKUMAZ: gönderim ziyaretçinin yaptığı iştir, gelen kutusu KİŞİSEL VERİDİR (mig 1505).

İstek

curl -X POST "https://{slug}--panel.web.blesyum.app/api/web/public/v1/forms/<id>/submit" \
  -H "Authorization: Bearer blsk_..." \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

PATCH/api/web/v1/forms/{form}

`PATCH /api/web/v1/posts/{post}`

OturumYol parametresi: form

İstek

curl -X PATCH "https://{slug}--panel.web.blesyum.app/api/web/v1/forms/<form>" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/web/v1/forms/{form}/submissions

`GET /api/web/v1/forms/{form}/submissions`

OturumYol parametresi: form

🔴 Kapı `FORMS_READ`tir, `VIEW` DEĞİL: bu satırlar kişisel veridir.

İstek

curl -X GET "https://{slug}--panel.web.blesyum.app/api/web/v1/forms/<form>/submissions" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}

GET/api/web/v1/forms/{form}/submissions.csv

`GET /api/web/v1/forms/{form}/submissions.csv`

OturumYol parametresi: form

⚠ Dosya **UTF-8 BOM** ile başlar: Excel BOM'suz UTF-8'i Windows-1254 sanar ve Türkçe harfler bozulur ("Şirket" → "Åirket"). Ölçüt dosyanın açılması değil, OKUNMASIDIR.

İstek

curl -X GET "https://{slug}--panel.web.blesyum.app/api/web/v1/forms/<form>/submissions.csv" \
  -H "Authorization: Bearer <oturum-token>" \
  -H "Accept: application/json"

Yanıt

{
  "data": "…",
  "trace_id": "01JC…"
}