Documentación de API

Integra QualifyForm en tus aplicaciones

Primeros Pasos

La API de QualifyForm te permite interactuar programáticamente con tus formularios y respuestas. Todas las solicitudes requieren autenticación.

Base URL: https://www.qualifyform.com/api

Autenticación

Autentica tus solicitudes usando un token Bearer en el encabezado Authorization. Puedes encontrar tu clave API en la configuración de tu cuenta.

curl -X GET "https://www.qualifyform.com/api/forms" \
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoints

GET/api/forms

Obtén una lista de todos tus formularios.

Respuesta

{
  "forms": [
    {
      "id": "uuid",
      "title": "Contact Form",
      "slug": "contact-form",
      "status": "published",
      "created_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-01T00:00:00Z"
    }
  ]
}
GET/api/responses?form_id=:formId

Obtén las respuestas de un formulario específico.

Parámetros

ParámetroTipoDescripción
form_idstringEl ID del formulario del cual obtener respuestas

Respuesta

{
  "responses": [
    {
      "id": "uuid",
      "form_id": "uuid",
      "answers": {
        "question_1": "Answer text",
        "question_2": ["option_a", "option_b"]
      },
      "created_at": "2025-01-01T00:00:00Z"
    }
  ]
}
POST/api/responses

Envía una nueva respuesta a un formulario.

Cuerpo de la Solicitud

{
  "form_id": "uuid",
  "answers": {
    "question_1": "Answer text",
    "question_2": ["option_a", "option_b"]
  }
}

Respuesta

{
  "success": true,
  "response_id": "uuid"
}

Incrustar Formularios

Puedes incrustar formularios de QualifyForm en tu sitio web usando nuestro script de embed JavaScript.

Embed en Línea

<div
  data-qualifyform="your-form-slug"
  data-mode="inline"
  data-height="500px"
></div>
<script src="https://www.qualifyform.com/embed.js" async></script>

Embed Popup

<div
  data-qualifyform="your-form-slug"
  data-mode="popup"
  data-button-text="Open Form"
></div>
<script src="https://www.qualifyform.com/embed.js" async></script>

Embed Popover

<script
  src="https://www.qualifyform.com/embed.js"
  data-qualifyform="your-form-slug"
  data-mode="popover"
  async
></script>

Límites de Solicitudes

Las solicitudes a la API están limitadas según tu plan:

PlanLímite
Free100 requests/hour
Pro1,000 requests/hour
EnterpriseIlimitado

Soporte

¿Necesitas ayuda con la API? Contacta a nuestro equipo de soporte en:
support@qualifyform.com