Suscribirse mediante un formulario
El endpoint al que envían los visitantes de un formulario publicado. No requiere ninguna credencial, así que llámalo desde un navegador o desde tu propio servidor, desde cualquier origen.
Ejecuta la llamada real en tu espacio de trabajo.
POST /subscribe/{formId}
El endpoint al que envían los visitantes de un formulario publicado. No requiere ninguna credencial, así que llámalo desde un navegador o desde tu propio servidor, desde cualquier origen.
Ejemplo
Envía las respuestas con la clave de cada campo como nombre, en el nivel superior o dentro de values. Con Accept: application/json o un cuerpo JSON, la respuesta es JSON. Un formulario HTML simple se redirige en su lugar con un 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 es added cuando la persona ya está en las audiencias, o pending en un formulario con doble opt-in, donde se une a ellas cuando confirma por correo. Ese correo sale después de esta respuesta, salvo que este formulario haya escrito a la dirección en los últimos diez minutos o que la dirección ya haya recibido hoy cinco correos de este espacio de trabajo.
Una respuesta que falta o es incorrecta es un 422 invalid_form_submission. El error lleva fields, una lista de { "key", "error" } con motivos como required, email u option.
Un formulario en pausa responde 409 form_closed, uno desconocido o sin publicar 404 form_not_found, y demasiadas suscripciones desde una misma red reciben 429 form_rate_limited. Un formulario HTML simple recibe en su lugar un 303 a la página alojada.
Las respuestas a claves que el formulario no tiene se ignoran, y las claves que empiezan por oe_ nunca se guardan. oe_source indica la página en la que estaba el formulario, y por defecto toma la cabecera Referer.
