Public Formlar

Frontend uygulamalardan form yanıtı göndermek için kullanılan endpoint.

Base URL: /api/public/forms Yetkilendirme: X-Api-Key

bilgi

Controller AllowAnonymous olsa da tenant çözümleme için X-Api-Key header'ı gereklidir.

---

POST /{code}/submit

Belirli bir forma yanıt gönderir.

Headers:

X-Api-Key: customer-api-key

Request Body:

{
  "fields": [
    {
      "name": "name",
      "value": "Ali Veli"
    },
    {
      "name": "email",
      "value": "ali@example.com"
    },
    {
      "name": "message",
      "value": "Merhaba"
    }
  ],
  "sourceUrl": "https://example.com/contact",
  "referrer": "https://google.com"
}

Alan	Tip	Zorunlu	Açıklama
fields	PublicSubmitFormFieldRequest[]	Evet	Gönderilen alan listesi
sourceUrl	string	Hayır	Formun gönderildiği sayfa URL'i
referrer	string	Hayır	Yönlendiren sayfa

PublicSubmitFormFieldRequest

Alan	Tip	Zorunlu	Açıklama
name	string	Evet	Alan adı
value	string	Hayır	Alan değeri

Response — 201 Created:

{
  "success": true,
  "data": {
    "submissionId": "4e6c4a42-...",
    "status": "New",
    "submittedAt": "2026-03-28T14:15:00Z"
  }
}

---

Notlar

• Form alanlarının CMS tarafında önceden tanımlanması gerekmez.
• code, tenant panelinden oluşturulan formun benzersiz kodudur.
• Form aktif değilse veya isPublic = false ise submit kabul edilmez.
• IpAddress ve UserAgent bilgileri request üzerinden otomatik kaydedilir.
• Aynı name değeri istenirse birden fazla kez gönderilebilir.

---

Olası Hatalar

Kod	Durum
403	Forms modülü müşteriye atanmadı veya form public/aktif değil
404	Form bulunamadı
400	fields boş, name eksik veya body geçersiz