Forms
Obtener formulario
Obtener la configuración y campos de un formulario.
GET
/
api
/
forms
/
{formId}
curl -X GET "https://app.horneross.com/api/forms/form_abc123"
const response = await fetch('https://app.horneross.com/api/forms/form_abc123');
const form = await response.json();
import requests
response = requests.get('https://app.horneross.com/api/forms/form_abc123')
form = response.json()
{
"id": "form_abc123",
"name": "Formulario de Contacto",
"description": "Dejanos tus datos y te contactamos",
"fields": [
{
"id": "field_name",
"name": "name",
"label": "Nombre completo",
"type": "text",
"required": true,
"placeholder": "Ingresá tu nombre"
},
{
"id": "field_email",
"name": "email",
"label": "Email",
"type": "email",
"required": true,
"placeholder": "tu@email.com"
},
{
"id": "field_phone",
"name": "phone",
"label": "Teléfono",
"type": "phone",
"required": false
},
{
"id": "field_message",
"name": "message",
"label": "Mensaje",
"type": "textarea",
"required": true,
"placeholder": "¿En qué podemos ayudarte?"
},
{
"id": "field_plan",
"name": "plan",
"label": "Plan de interés",
"type": "select",
"options": [
{"value": "starter", "label": "Starter"},
{"value": "pro", "label": "Pro"},
{"value": "enterprise", "label": "Enterprise"}
],
"required": false
}
],
"settings": {
"submitButtonText": "Enviar consulta",
"successMessage": "¡Gracias! Te contactaremos pronto."
}
}
Endpoint
GET /api/forms/{formId}
Este endpoint es público y no requiere autenticación.
Path Parameters
ID único del formulario
curl -X GET "https://app.horneross.com/api/forms/form_abc123"
const response = await fetch('https://app.horneross.com/api/forms/form_abc123');
const form = await response.json();
import requests
response = requests.get('https://app.horneross.com/api/forms/form_abc123')
form = response.json()
Response
ID único del formulario
Nombre del formulario
Descripción del formulario mostrada al usuario
Array de campos del formulario
Show Propiedades de cada campo
Show Propiedades de cada campo
ID único del campo
Nombre del campo (usado como key en formValues)
Etiqueta mostrada al usuario
Tipo de campo:
text, email, phone, textarea, select, radio, checkbox, number, date, fileSi el campo es obligatorio
Texto placeholder
{
"id": "form_abc123",
"name": "Formulario de Contacto",
"description": "Dejanos tus datos y te contactamos",
"fields": [
{
"id": "field_name",
"name": "name",
"label": "Nombre completo",
"type": "text",
"required": true,
"placeholder": "Ingresá tu nombre"
},
{
"id": "field_email",
"name": "email",
"label": "Email",
"type": "email",
"required": true,
"placeholder": "tu@email.com"
},
{
"id": "field_phone",
"name": "phone",
"label": "Teléfono",
"type": "phone",
"required": false
},
{
"id": "field_message",
"name": "message",
"label": "Mensaje",
"type": "textarea",
"required": true,
"placeholder": "¿En qué podemos ayudarte?"
},
{
"id": "field_plan",
"name": "plan",
"label": "Plan de interés",
"type": "select",
"options": [
{"value": "starter", "label": "Starter"},
{"value": "pro", "label": "Pro"},
{"value": "enterprise", "label": "Enterprise"}
],
"required": false
}
],
"settings": {
"submitButtonText": "Enviar consulta",
"successMessage": "¡Gracias! Te contactaremos pronto."
}
}
Tipos de campos
| Tipo | Descripción |
|---|---|
text | Texto libre |
email | Email con validación |
phone | Teléfono |
textarea | Texto largo |
select | Lista desplegable |
radio | Opciones únicas |
checkbox | Opciones múltiples |
number | Valor numérico |
date | Selector de fecha |
file | Upload de archivo |
Was this page helpful?
⌘I
curl -X GET "https://app.horneross.com/api/forms/form_abc123"
const response = await fetch('https://app.horneross.com/api/forms/form_abc123');
const form = await response.json();
import requests
response = requests.get('https://app.horneross.com/api/forms/form_abc123')
form = response.json()
{
"id": "form_abc123",
"name": "Formulario de Contacto",
"description": "Dejanos tus datos y te contactamos",
"fields": [
{
"id": "field_name",
"name": "name",
"label": "Nombre completo",
"type": "text",
"required": true,
"placeholder": "Ingresá tu nombre"
},
{
"id": "field_email",
"name": "email",
"label": "Email",
"type": "email",
"required": true,
"placeholder": "tu@email.com"
},
{
"id": "field_phone",
"name": "phone",
"label": "Teléfono",
"type": "phone",
"required": false
},
{
"id": "field_message",
"name": "message",
"label": "Mensaje",
"type": "textarea",
"required": true,
"placeholder": "¿En qué podemos ayudarte?"
},
{
"id": "field_plan",
"name": "plan",
"label": "Plan de interés",
"type": "select",
"options": [
{"value": "starter", "label": "Starter"},
{"value": "pro", "label": "Pro"},
{"value": "enterprise", "label": "Enterprise"}
],
"required": false
}
],
"settings": {
"submitButtonText": "Enviar consulta",
"successMessage": "¡Gracias! Te contactaremos pronto."
}
}