Horneross - Automatización de Operaciones

GET

api

forms

{formId}

curl -X GET "https://app.horneross.com/api/forms/form_abc123"

{
  "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

formId

string

required

ID único del formulario

curl -X GET "https://app.horneross.com/api/forms/form_abc123"

Response

string

required

ID único del formulario

name

string

required

Nombre del formulario

description

string

Descripción del formulario mostrada al usuario

fields

array

required

Array de campos del formulario

Show Propiedades de cada campo

fields[].id

string

required

ID único del campo

fields[].name

string

required

Nombre del campo (usado como key en formValues)

fields[].label

string

required

Etiqueta mostrada al usuario

fields[].type

string

required

Tipo de campo: text, email, phone, textarea, select, radio, checkbox, number, date, file

fields[].required

boolean

Si el campo es obligatorio

fields[].placeholder

string

Texto placeholder

fields[].options

array

Opciones para campos select/radio/checkbox

Show Propiedades de option

fields[].options[].value

string

Valor de la opción

fields[].options[].label

string

Texto mostrado

settings

object

Configuración de UI del formulario

Show Propiedades de settings

settings.submitButtonText

string

Texto del botón de envío

settings.successMessage

string

Mensaje mostrado después de enviar

{
  "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

Enviar submissionEnviar los datos completados del formulario.

curl -X GET "https://app.horneross.com/api/forms/form_abc123"

{
  "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

​Path Parameters

​Response

​Tipos de campos

Endpoint

Path Parameters

Response

Tipos de campos