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.

Démarrage rapide
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

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

Tous les endpoints sont préfixés par l'URL de base versionnée

AuthentificationAuthorization: Bearer

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ébit60 requêtes/minute

Limitation de débit par clé par défaut, avec des paliers supérieurs disponibles ; les en-têtes indiquent le quota restant

FormatJSON (application/json)

Toutes les requêtes et réponses utilisent l'encodage JSON en UTF-8

ChiffrementTLS 1.3 requis

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

GET
/api/v1/surveys

Liste toutes les enquêtes avec pagination, filtrage et tri

POST
/api/v1/surveys

Crée une nouvelle enquête avec questions, logique et paramètres

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

Récupère les réponses aux enquêtes avec un filtrage avancé

POST
/api/v1/email-campaigns

Lance des campagnes de distribution par e-mail vers des listes d'audience

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

Obtient des analyses avec graphiques, tendances et informations d'IA

POST
/api/v1/webhooks

Enregistre 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
Exemple 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 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é
Exemple 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 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
Exemple 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+ · 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
Exemple 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 avec Compose
  • Thème Material3
  • Catalogue de versions Gradle
  • Coroutines et Flow
Exemple 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

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.created

Déclenché lorsqu'une nouvelle réponse à une enquête est soumise

response.updated

Déclenché lorsqu'une réponse partielle est mise à jour ou complétée

survey.published

Déclenché lorsqu'une enquête est publiée et mise en ligne

survey.closed

Déclenché lorsqu'une enquête est fermée aux nouvelles réponses

campaign.sent

Déclenché lorsqu'une campagne de distribution est lancée

campaign.delivered

Déclenché lorsque les messages de la campagne sont distribués

campaign.bounced

Déclenché lorsque les messages de la campagne sont rejetés

contact.opted_out

Dé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.

Exemple de charge utile 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=..."
}

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.

Automatisation

Zapier

Connectez-vous à plus de 5 000 applications avec des déclencheurs et des actions

Automatisation

Make

Automatisation visuelle des flux de travail avec des scénarios complexes

CRM

Salesforce

Synchronisez les réponses avec les contacts, les pistes et les requêtes

CRM

HubSpot

Associez les données d'enquête aux transactions, contacts et tickets

E-mail

Mailchimp

Déclenchez des enquêtes à partir de campagnes e-mail et de segments

E-mail

Klaviyo

Intégrez des enquêtes dans les parcours clients

Messagerie

Slack

Distribuez des enquêtes et recevez des notifications dans les canaux

Messagerie

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.

01

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.

02

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.

03

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.

75+
Endpoints d'API
4
SDK natifs
99,9 %
Disponibilité de l'API
<100ms
Temps de réponse moyen

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.

Accès gratuit à l'APIAucune carte bancaire requiseDocumentation complète