Belgelere geç
API

Bir form üzerinden kaydolma

Yayımlanmış bir formun ziyaretçilerinin gönderdiği yer. Kimlik bilgisi gerektirmez, bu yüzden onu bir tarayıcıdan ya da kendi sunucunuzdan, herhangi bir kaynaktan çağırın.

POST/subscribe/{formId}

Gerçek çağrıyı çalışma alanınızda çalıştırır.

POST /subscribe/{formId}

Yayımlanmış bir formun ziyaretçilerinin gönderdiği yer. Kimlik bilgisi gerektirmez, bu yüzden onu bir tarayıcıdan ya da kendi sunucunuzdan, herhangi bir kaynaktan çağırın.

Örnek

Yanıtları alan anahtarlarıyla eşleyerek, en üst düzeyde ya da values altında gönderin. Accept: application/json ya da bir JSON gövdesiyle yanıt JSON olur. Düz bir HTML formu ise bunun yerine 303 ile yönlendirilir.

curl
curl -X POST "$OE/subscribe/frm_3b9d2e7a1c4f80d56e2a9b14" -H 'content-type: application/json' -d '{  "email": "[email protected]",  "first_name": "Ann",  "consent": true}'
Yanıt
{  "object": "form_subscription",  "formId": "frm_3b9d2e7a1c4f80d56e2a9b14",  "outcome": "pending",  "redirectUrl": null}

outcome, kişi şu anda kitlelerdeyse added, çift onaylı bir formdaysa pending olur; bu durumda kişi e-postayla onayladığında kitlelere katılır. O e-posta bu yanıttan sonra gönderilir; ancak bu form son on dakikada o adrese e-posta gönderdiyse ya da adres bugün bu çalışma alanından beş onay aldıysa gönderilmez.

Eksik ya da yanlış bir yanıt 422 invalid_form_submission olur. Hata, required, email ya da option gibi nedenlerle birlikte bir { "key", "error" } listesi olan fields değerini taşır.

Duraklatılmış bir form 409 form_closed, bilinmeyen ya da yayımlanmamış bir form 404 form_not_found, tek bir ağdan gelen çok fazla kayıt ise 429 form_rate_limited yanıtını alır. Düz bir HTML formu ise bunun yerine 303 ile barındırılan sayfaya yönlendirilir.

Formda olmayan anahtarlara verilen yanıtlar yok sayılır ve oe_ ile başlayan anahtarlar asla saklanmaz. oe_source formun bulunduğu sayfayı belirtir ve varsayılan olarak Referer başlığından alınır.

Gelen kutunuz,
kendi kurallarınızla.

İşletmeler, yapay zekâ, ajanlar ve kişisel e-posta için e-posta altyapısı. Ölçek, gizlilik ve denetim için kuruldu. E-postanın ilk günden sahip olması gereken her şey.

© 2026 OpenEmail. Tüm hakları saklıdır.