फ़ॉर्म के ज़रिए साइन अप करें
जहाँ किसी प्रकाशित फ़ॉर्म के विज़िटर भेजते हैं। इसमें कोई क्रेडेंशियल नहीं लगता, इसलिए इसे ब्राउज़र से या अपने सर्वर से, किसी भी ओरिजिन से कॉल करें।
असली कॉल आपके वर्कस्पेस पर चलाता है।
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 हेडर है।
