الاشتراك عبر نموذج
الوجهة التي يرسل إليها زوار النموذج المنشور. لا تتطلب أي بيانات اعتماد، فاستدعها من متصفح أو من خادمك الخاص، ومن أي أصل.
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
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.
