Developers
Soporte
Forms
Obtener formulario
Obtener la configuración y campos de un formulario.
GET
/
api
/
forms
/
{formId}
Copy
curl -X GET "https://app.horneross.com/api/forms/form_abc123"
Copy
{
"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
Copy
GET /api/forms/{formId}
Este endpoint es público y no requiere autenticación.
Path Parameters
ID único del formulario
Copy
curl -X GET "https://app.horneross.com/api/forms/form_abc123"
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
Copy
{
"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
Copy
curl -X GET "https://app.horneross.com/api/forms/form_abc123"
Copy
{
"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."
}
}