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.
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
Todos los endpoints llevan el prefijo de la URL base versionada
Genera claves de API desde tu panel o usa JWT para acceso con alcance de usuario
Límite de uso por clave predeterminado, con niveles superiores disponibles; las cabeceras muestran la cuota restante
Todas las solicitudes y respuestas usan codificación JSON con UTF-8
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
/api/v1/surveysLista todas las encuestas con paginación, filtrado y ordenación
/api/v1/surveysCrea una nueva encuesta con preguntas, lógica y configuración
/api/v1/surveys/:id/responsesRecupera las respuestas de las encuestas con filtrado avanzado
/api/v1/email-campaignsLanza campañas de distribución por email a listas de audiencia
/api/v1/analytics/surveys/:idObtén análisis con gráficos, tendencias e información de IA
/api/v1/webhooksRegistra 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
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
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
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
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
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.createdSe activa cuando se envía una nueva respuesta de encuesta
response.updatedSe activa cuando una respuesta parcial se actualiza o se completa
survey.publishedSe activa cuando se publica una encuesta y entra en funcionamiento
survey.closedSe activa cuando se cierra una encuesta a nuevas respuestas
campaign.sentSe activa cuando se lanza una campaña de distribución
campaign.deliveredSe activa cuando se entregan los mensajes de la campaña
campaign.bouncedSe activa cuando los mensajes de la campaña rebotan
contact.opted_outSe 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.
{
"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.
Zapier
Conecta con más de 5.000 aplicaciones con disparadores y acciones
Make
Automatización visual de flujos de trabajo con escenarios complejos
Salesforce
Sincroniza respuestas con contactos, leads y casos
HubSpot
Asigna datos de encuestas a negocios, contactos y tickets
Mailchimp
Activa encuestas a partir de campañas de email y segmentos
Klaviyo
Integra encuestas en los flujos del recorrido del cliente
Slack
Distribuye encuestas y recibe notificaciones en los canales
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.
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.
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.
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.
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.