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
string
required
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
string
required
ID único del formulario
string
required
Nombre del formulario
string
Descripción del formulario mostrada al usuario
array
required
Array de campos del formulario
Show Propiedades de cada campo
Show Propiedades de cada campo
string
required
ID único del campo
string
required
Nombre del campo (usado como key en formValues)
string
required
Etiqueta mostrada al usuario
string
required
Tipo de campo:
text, email, phone, textarea, select, radio, checkbox, number, date, fileboolean
Si el campo es obligatorio
string
Texto placeholder
object
{
"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."
}
}