Recursos para desarrolladores

Hecho para desarrolladores, por desarrolladores

Una potente API REST, 4 SDK nativos sobre un TypeScript Core compartido, webhooks en tiempo real y más de 80 integraciones. Todo lo que necesitas para integrar encuestas en cualquier aplicación o flujo de trabajo.

Inicio rápido
curl -X GET https://api.claform.com/api/v1/surveys \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

API REST

Una API REST completa

Una API RESTful totalmente documentada con URL predecibles orientadas a recursos, cuerpos de solicitud/respuesta en JSON y métodos HTTP estándar.

Fundamentos de la API

URL basehttps://api.claform.com/api/v1

Todos los endpoints llevan el prefijo de la URL base versionada

AutenticaciónAuthorization: Bearer

Genera claves de API desde tu panel o usa JWT para acceso con alcance de usuario

Límite de uso60 solicitudes/minuto

Límite de uso por clave predeterminado, con niveles superiores disponibles; las cabeceras muestran la cuota restante

FormatoJSON (application/json)

Todas las solicitudes y respuestas usan codificación JSON con UTF-8

CifradoTLS 1.3 obligatorio

Todo el tráfico de la API se cifra de extremo a extremo a través de HTTPS

Ejemplo de autenticación

// Using API Key (recommended for server-to-server)
const headers = {
  'Authorization': 'Bearer sk_live_your_api_key',
  'Content-Type': 'application/json',
};

// Using JWT (for user-scoped access)
const { token } = await fetch('/api/v1/auth/login', {
  method: 'POST',
  body: JSON.stringify({ email, password }),
}).then(r => r.json());

Endpoints clave

GET
/api/v1/surveys

Lista todas las encuestas con paginación, filtrado y ordenación

POST
/api/v1/surveys

Crea una nueva encuesta con preguntas, lógica y configuración

GET
/api/v1/surveys/:id/responses

Recupera las respuestas de las encuestas con filtrado avanzado

POST
/api/v1/email-campaigns

Lanza campañas de distribución por email a listas de audiencia

GET
/api/v1/analytics/surveys/:id

Obtén análisis con gráficos, tendencias e información de IA

POST
/api/v1/webhooks

Registra endpoints de webhook para eventos en tiempo real

Más de 75 endpoints que abarcan encuestas, preguntas, respuestas, campañas, análisis, audiencias, contactos, integraciones, webhooks y administración. Paginación, filtrado y ordenación completos en todos los endpoints de listas.

SDK nativos

4 SDK nativos sobre un núcleo compartido

Integra encuestas de forma nativa en cualquier aplicación. Cuatro SDK nativos se basan en un motor compartido TypeScript Core, cada uno con los más de 35 tipos de preguntas, soporte sin conexión, temas, accesibilidad y gestión de eventos en tiempo real.

TypeScript Core

Web y Node.js · ~27KB comprimido

npm install @claform/sdk-core
  • TypeScript puro, sin dependencias
  • Más de 35 tipos de preguntas
  • Soporte sin conexión
  • Arquitectura basada en eventos
Ejemplo de TypeScript Core
import { SurveySDK } from '@claform/sdk-core';

const sdk = new SurveySDK({
  apiKey: 'your-api-key',
  baseUrl: 'https://api.claform.com/api/v1',
});

const survey = await sdk.loadSurvey('survey-id');
const response = await sdk.submitResponse(answers);

React Native

iOS y Android · 262KB + Core

npm install @claform/sdk-react-native
  • Componentes de UI nativos
  • 12 hooks personalizados
  • Cola sin conexión
  • Soporte de accesibilidad
Ejemplo de React Native
import { SurveyProvider, SurveyView } from '@claform/sdk-react-native';

function App() {
  return (
    <SurveyProvider apiKey="your-api-key">
      <SurveyView
        surveyId="survey-id"
        onComplete={(response) => console.log(response)}
      />
    </SurveyProvider>
  );
}

Flutter

iOS y Android · Dart puro

flutter pub add claform_sdk_flutter
  • Temas de Material 3
  • Gestión de estado con Provider
  • Sincronización sin conexión
  • Más de 35 widgets de preguntas
Ejemplo de Flutter
import 'package:claform_sdk_flutter/claform_sdk_flutter.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return SurveyProvider(
      apiKey: 'your-api-key',
      child: SurveyScreen(surveyId: 'survey-id'),
    );
  }
}

iOS (Swift)

iOS 15+ · Sin dependencias externas

.package(url: "https://github.com/claform/sdk-ios")
  • Vistas nativas de SwiftUI
  • SPM y CocoaPods
  • Puente con UIKit
  • Soporte de Dynamic Type
Ejemplo de iOS (Swift)
import ClaformSDK

struct ContentView: View {
    var body: some View {
        SurveyView(
            apiKey: "your-api-key",
            surveyId: "survey-id"
        ) { response in
            print("Completed: \(response)")
        }
    }
}

Android (Kotlin)

API 24+ · Jetpack Compose

implementation("com.claform:sdk-android:1.0.0")
  • UI con Compose
  • Tema Material3
  • Catálogo de versiones de Gradle
  • Coroutines y Flow
Ejemplo de Android (Kotlin)
import com.claform.sdk.SurveyScreen
import com.claform.sdk.SurveyViewModel

@Composable
fun SurveyPage(viewModel: SurveyViewModel = viewModel()) {
    SurveyScreen(
        apiKey = "your-api-key",
        surveyId = "survey-id",
        onComplete = { response -> /* handle */ }
    )
}

Webhooks

Notificaciones de eventos en tiempo real

Suscríbete a los eventos y recibe callbacks HTTP instantáneos cuando ocurra algo en tu cuenta. Sin necesidad de sondeo.

Eventos admitidos

response.created

Se activa cuando se envía una nueva respuesta de encuesta

response.updated

Se activa cuando una respuesta parcial se actualiza o se completa

survey.published

Se activa cuando se publica una encuesta y entra en funcionamiento

survey.closed

Se activa cuando se cierra una encuesta a nuevas respuestas

campaign.sent

Se activa cuando se lanza una campaña de distribución

campaign.delivered

Se activa cuando se entregan los mensajes de la campaña

campaign.bounced

Se activa cuando los mensajes de la campaña rebotan

contact.opted_out

Se activa cuando un contacto se da de baja o se excluye

Características de los webhooks

  • Verificación de firma

    Cada carga útil de webhook se firma con HMAC-SHA256 usando tu clave secreta para una entrega a prueba de manipulaciones.

  • Reintentos automáticos

    Las entregas fallidas se reintentan con retroceso exponencial hasta 5 veces durante 24 horas.

  • Registros de entrega

    Historial completo de entregas con cuerpos de solicitud/respuesta, códigos de estado y tiempos para la depuración.

  • Filtrado de eventos

    Suscríbete solo a los eventos que te interesan. Filtra por encuesta, campaña o tipo de evento.

Ejemplo de carga útil de webhook
{
  "event": "response.created",
  "timestamp": "2026-04-05T14:30:00Z",
  "data": {
    "responseId": "resp_abc123",
    "surveyId": "srv_xyz789",
    "status": "completed",
    "completionTime": 245,
    "answers": [...]
  },
  "signature": "sha256=..."
}

Integraciones

Conecta toda tu tecnología

Conectores prediseñados para las plataformas más populares, además de Zapier y Make para conectar con miles más.

Automatización

Zapier

Conecta con más de 5.000 aplicaciones con disparadores y acciones

Automatización

Make

Automatización visual de flujos de trabajo con escenarios complejos

CRM

Salesforce

Sincroniza respuestas con contactos, leads y casos

CRM

HubSpot

Asigna datos de encuestas a negocios, contactos y tickets

Email

Mailchimp

Activa encuestas a partir de campañas de email y segmentos

Email

Klaviyo

Integra encuestas en los flujos del recorrido del cliente

Mensajería

Slack

Distribuye encuestas y recibe notificaciones en los canales

Mensajería

Microsoft Teams

Envía encuestas mediante bots y pestañas de Teams

Inicio rápido

Operativo en 3 pasos

Desde el registro hasta tu primera llamada a la API en menos de 5 minutos.

01

Obtén tu clave de API

Crea una cuenta gratuita y genera una clave de API desde tu panel. Las claves tienen alcance por proyecto, con permisos y límites de uso configurables.

02

Instala un SDK

Elige entre 4 SDK nativos o usa la API REST directamente. Cada SDK incluye definiciones completas de TypeScript/tipos, documentación detallada y código de ejemplo.

03

Publícalo

Crea tu primera encuesta, intégrala en tu aplicación y empieza a recopilar respuestas. Usa webhooks para activar flujos de trabajo en tiempo real.

75+
Endpoints de API
4
SDK nativos
99,9%
Disponibilidad de la API
<100ms
Tiempo de respuesta medio

Empieza a crear hoy

Obtén tu clave de API gratuita y haz tu primera llamada a la API en minutos. Nuestro generoso nivel gratuito incluye 1.000 solicitudes de API al día.

Acceso gratuito a la APISin tarjeta de créditoDocumentación completa