ثبتنام از راه یک فرم
جایی که بازدیدکنندگان یک فرم منتشرشده به آن ارسال میکنند. هیچ اعتبارنامهای نمیگیرد، پس آن را از مرورگر یا سرور خودتان، از هر مبدئی، فراخوانی کنید.
فراخوانی واقعی را روی فضای کاری شما اجرا میکند.
POST /subscribe/{formId}
جایی که بازدیدکنندگان یک فرم منتشرشده به آن ارسال میکنند. هیچ اعتبارنامهای نمیگیرد، پس آن را از مرورگر یا سرور خودتان، از هر مبدئی، فراخوانی کنید.
نمونه
جوابها را با کلید فیلدها، در سطح بالا یا زیر values، بفرستید. با Accept: application/json یا یک بدنهٔ JSON پاسخ JSON است. یک فرم HTML ساده بهجای آن با 303 هدایت میشود.
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 است.