Ressources pour développeurs
Conçu pour les développeurs, par des développeurs
Une puissante API REST, 4 SDK natifs reposant sur un TypeScript Core partagé, des webhooks en temps réel et plus de 80 intégrations. Tout ce dont vous avez besoin pour intégrer des enquêtes dans n'importe quelle application ou n'importe quel flux de travail.
curl -X GET https://api.claform.com/api/v1/surveys \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"API REST
Une API REST complète
Une API RESTful entièrement documentée avec des URL prévisibles orientées ressources, des corps de requête/réponse en JSON et des méthodes HTTP standard.
Fondamentaux de l'API
Tous les endpoints sont préfixés par l'URL de base versionnée
Générez des clés d'API depuis votre tableau de bord ou utilisez un JWT pour un accès à l'échelle de l'utilisateur
Limitation de débit par clé par défaut, avec des paliers supérieurs disponibles ; les en-têtes indiquent le quota restant
Toutes les requêtes et réponses utilisent l'encodage JSON en UTF-8
Tout le trafic de l'API est chiffré de bout en bout via HTTPS
Exemple d'authentification
// 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 clés
/api/v1/surveysListe toutes les enquêtes avec pagination, filtrage et tri
/api/v1/surveysCrée une nouvelle enquête avec questions, logique et paramètres
/api/v1/surveys/:id/responsesRécupère les réponses aux enquêtes avec un filtrage avancé
/api/v1/email-campaignsLance des campagnes de distribution par e-mail vers des listes d'audience
/api/v1/analytics/surveys/:idObtient des analyses avec graphiques, tendances et informations d'IA
/api/v1/webhooksEnregistre des endpoints de webhook pour les événements en temps réel
Plus de 75 endpoints couvrant les enquêtes, les questions, les réponses, les campagnes, les analyses, les audiences, les contacts, les intégrations, les webhooks et l'administration. Pagination, filtrage et tri complets sur tous les endpoints de liste.
SDK natifs
4 SDK natifs sur un cœur partagé
Intégrez nativement des enquêtes dans n'importe quelle application. Quatre SDK natifs reposent sur un moteur partagé TypeScript Core, chacun avec les plus de 35 types de questions, la prise en charge hors ligne, les thèmes, l'accessibilité et la gestion des événements en temps réel.
TypeScript Core
Web et Node.js · ~27 Ko compressé
npm install @claform/sdk-core- TypeScript pur, sans dépendances
- Plus de 35 types de questions
- Prise en charge hors ligne
- Architecture événementielle
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 et Android · 262 Ko + Core
npm install @claform/sdk-react-native- Composants d'UI natifs
- 12 hooks personnalisés
- File d'attente hors ligne
- Prise en charge de l'accessibilité
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 et Android · Dart pur
flutter pub add claform_sdk_flutter- Thèmes Material 3
- Gestion d'état avec Provider
- Synchronisation hors ligne
- Plus de 35 widgets de questions
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+ · Sans dépendances externes
.package(url: "https://github.com/claform/sdk-ios")- Vues natives SwiftUI
- SPM et CocoaPods
- Pont UIKit
- Prise en charge 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 avec Compose
- Thème Material3
- Catalogue de versions Gradle
- Coroutines et 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
Notifications d'événements en temps réel
Abonnez-vous aux événements et recevez des rappels HTTP instantanés lorsque quelque chose se produit sur votre compte. Aucun sondage requis.
Événements pris en charge
response.createdDéclenché lorsqu'une nouvelle réponse à une enquête est soumise
response.updatedDéclenché lorsqu'une réponse partielle est mise à jour ou complétée
survey.publishedDéclenché lorsqu'une enquête est publiée et mise en ligne
survey.closedDéclenché lorsqu'une enquête est fermée aux nouvelles réponses
campaign.sentDéclenché lorsqu'une campagne de distribution est lancée
campaign.deliveredDéclenché lorsque les messages de la campagne sont distribués
campaign.bouncedDéclenché lorsque les messages de la campagne sont rejetés
contact.opted_outDéclenché lorsqu'un contact se désabonne ou se désinscrit
Fonctionnalités des webhooks
- Vérification de signature
Chaque charge utile de webhook est signée avec HMAC-SHA256 à l'aide de votre clé secrète pour une distribution infalsifiable.
- Nouvelles tentatives automatiques
Les distributions échouées font l'objet de nouvelles tentatives avec un délai exponentiel jusqu'à 5 fois sur 24 heures.
- Journaux de distribution
Historique complet des distributions avec les corps de requête/réponse, les codes de statut et les durées pour le débogage.
- Filtrage des événements
Abonnez-vous uniquement aux événements qui vous intéressent. Filtrez par enquête, campagne ou type d'événement.
{
"event": "response.created",
"timestamp": "2026-04-05T14:30:00Z",
"data": {
"responseId": "resp_abc123",
"surveyId": "srv_xyz789",
"status": "completed",
"completionTime": 245,
"answers": [...]
},
"signature": "sha256=..."
}Intégrations
Connectez toute votre pile technologique
Des connecteurs préconçus pour les plateformes les plus populaires, ainsi que Zapier et Make pour vous connecter à des milliers d'autres.
Zapier
Connectez-vous à plus de 5 000 applications avec des déclencheurs et des actions
Make
Automatisation visuelle des flux de travail avec des scénarios complexes
Salesforce
Synchronisez les réponses avec les contacts, les pistes et les requêtes
HubSpot
Associez les données d'enquête aux transactions, contacts et tickets
Mailchimp
Déclenchez des enquêtes à partir de campagnes e-mail et de segments
Klaviyo
Intégrez des enquêtes dans les parcours clients
Slack
Distribuez des enquêtes et recevez des notifications dans les canaux
Microsoft Teams
Envoyez des enquêtes via les bots et onglets Teams
Démarrage rapide
Opérationnel en 3 étapes
De l'inscription à votre premier appel d'API en moins de 5 minutes.
Obtenez votre clé d'API
Créez un compte gratuit et générez une clé d'API depuis votre tableau de bord. Les clés sont limitées par projet, avec des autorisations et des limites de débit configurables.
Installez un SDK
Choisissez parmi 4 SDK natifs ou utilisez directement l'API REST. Chaque SDK inclut des définitions TypeScript/de types complètes, une documentation détaillée et du code d'exemple.
Déployez-le
Créez votre première enquête, intégrez-la dans votre application et commencez à recueillir des réponses. Utilisez les webhooks pour déclencher des flux de travail en temps réel.
Commencez à créer dès aujourd'hui
Obtenez votre clé d'API gratuite et effectuez votre premier appel d'API en quelques minutes. Notre offre gratuite généreuse inclut 1 000 requêtes d'API par jour.