پرش به مستندات
API

ثبت‌نام از راه یک فرم

جایی که بازدیدکنندگان یک فرم منتشرشده به آن ارسال می‌کنند. هیچ اعتبارنامه‌ای نمی‌گیرد، پس آن را از مرورگر یا سرور خودتان، از هر مبدئی، فراخوانی کنید.

POST/subscribe/{formId}

فراخوانی واقعی را روی فضای کاری شما اجرا می‌کند.

POST /subscribe/{formId}

جایی که بازدیدکنندگان یک فرم منتشرشده به آن ارسال می‌کنند. هیچ اعتبارنامه‌ای نمی‌گیرد، پس آن را از مرورگر یا سرور خودتان، از هر مبدئی، فراخوانی کنید.

نمونه

جواب‌ها را با کلید فیلدها، در سطح بالا یا زیر values، بفرستید. با Accept: application/json یا یک بدنهٔ JSON پاسخ JSON است. یک فرم HTML ساده به‌جای آن با 303 هدایت می‌شود.

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

outcome وقتی شخص اکنون در گروه‌های مخاطبان است برابر added است، یا در فرمی با تأیید دوگانه برابر pending، که شخص وقتی با ایمیل تأیید کند می‌پیوندد. آن ایمیل پس از این پاسخ فرستاده می‌شود، مگر آنکه این فرم در ده دقیقهٔ گذشته به آن نشانی ایمیلی فرستاده باشد یا آن نشانی امروز پنج پیام تأیید از این فضای کاری گرفته باشد.

جوابی که جا افتاده یا نادرست است 422 invalid_form_submission است. خطا fields را با خود دارد، فهرستی از { "key", "error" } با دلیل‌هایی مانند required، email یا option.

فرم متوقف با 409 form_closed پاسخ می‌دهد، فرم ناشناخته یا منتشرنشده با 404 form_not_found، و ثبت‌نام‌های بیش از حد از یک شبکه با 429 form_rate_limited. یک فرم HTML ساده به‌جای آن با 303 به صفحهٔ میزبانی‌شده هدایت می‌شود.

جواب‌های کلیدهایی که فرم ندارد نادیده گرفته می‌شوند، و کلیدهایی که با oe_ شروع می‌شوند هرگز ذخیره نمی‌شوند. oe_source صفحه‌ای را که فرم روی آن بود نام می‌برد، و پیش‌فرضش سرآیند Referer است.

صندوق ورودی شما،
با شرایط خودتان.

زیرساخت ایمیل برای کسب‌وکارها، هوش مصنوعی، عامل‌ها و ایمیل شخصی. ساخته‌شده برای مقیاس، حریم خصوصی و کنترل. هر چه ایمیل باید از روز نخست می‌داشت.

© 2026 OpenEmail. همه حقوق محفوظ است.