submissions
5 uç · /api/web/v1/submissions
İstek örnekleri ucun GERÇEK metodu ve yolundan üretilir. 5 ucun elle doğrulanmış gövde örneği henüz yok; o uçlarda iskelet gövdesizdir — uydurma bir alan yazmıyoruz.
PATCH /api/web/v1/submissions/{id} — durum · atama · etiket · not.
id🔴 Kapı FORMS_READ: gelen kutusunu okuyamayan biri onu YÖNETEMEZ de.
Ayrı bir "forms.write" izni açmak, kullanıcıya ikinci bir kutu daha
işaretletmek olurdu — ve o kutu işaretlenmediğinde ekip, açtığı gönderimi
"işlendi" yapamayan bir gelen kutusuyla kalırdı.
curl -X PATCH "https://{slug}--panel.web.blesyum.app/api/web/v1/submissions/<id>" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}DELETE /api/web/v1/submissions/{id}
id⚠ KVKK: kişinin "sil" talebinin ürün içindeki karşılığı budur. Geri alınamaz olduğu için DENETİME yazılır (DOM-32).
curl -X DELETE "https://{slug}--panel.web.blesyum.app/api/web/v1/submissions/<id>" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}GET /api/web/v1/submissions/{id}/files/{index} — ek indirme.
idindex# 🔴 Ek HİÇBİR public yoldan servis EDİLMEZ
Ziyaretçinin gönderdiği bir CV ya da fatura KİŞİSEL VERİDİR: adresi
tahmin edilebilir bir medya yolundan sunmak, o dosyayı bağlantıyı bilen
herkese açmaktır. Tek kapı budur ve web.forms.read ister.
# 🔴 attachment — inline DEĞİL
PDF (ve tanımadığımız her tür) panel origin'inde INLINE açılırsa, dosyanın
içindeki JS panelin origin'inde koşar. İndirme zorunlu, nosniff şart.
⚠ Anahtar SATIRDAN gelir, istemciden DEĞİL: gövdeden anahtar kabul eden bir
uç, web/<başka-kiracı>/… okumanın yolu olurdu.
curl -X GET "https://{slug}--panel.web.blesyum.app/api/web/v1/submissions/<id>/files/<index>" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}POST /api/web/v1/submissions/{id}/notes — değerlendirme notu ekle.
id# 🔴 Defter APPEND-ONLY
Not düzenlenmez, silinmez; gönderim silinince cascade ile gider. "Kim, ne
zaman, ne dedi" değiştirilebilseydi ikinci görüşmecinin notu birincininkini
ezerdi — tam da tek note alanının yaşattığı şey.
⚠ Kapı FORMS_READ: gelen kutusunu okuyan herkes not düşebilir
(gönderimi yönetmenin aynı kararı).
curl -X POST "https://{slug}--panel.web.blesyum.app/api/web/v1/submissions/<id>/notes" \
-H "Authorization: Bearer <oturum-token>" \
-H "Accept: application/json"{
"data": "…",
"trace_id": "01JC…"
}