Référence API
Documentation technique pour intégrer Cumino dans vos systèmes. API REST avec authentification OAuth2 et webhooks en temps réel.
URL de base
Catégories d'Endpoints
Authentification
- Flux OAuth2
- Clés API
- Tokens JWT
- Scopes et permissions
Candidats
- GET /candidates
- POST /candidates
- PUT /candidates/:id
- DELETE /candidates/:id
Campagnes
- GET /campaigns
- POST /campaigns
- GET /campaigns/:id/leads
- PUT /campaigns/:id/status
Limitation de Débit
- 1000 req/minute (standard)
- 5000 req/minute (enterprise)
- En-têtes de réponse
- Support Retry-After
Démarrage Rapide
Obtenez votre Clé API
Enregistrez votre application dans le tableau de bord Cumino et générez vos identifiants API.
Authentification
Utilisez vos identifiants pour obtenir un token JWT via l'endpoint /auth/token.
Premier appel
Testez la connexion avec GET /health et commencez à utiliser les endpoints.
Configurez les Webhooks
Enregistrez vos endpoints pour recevoir des notifications en temps réel sur les événements.
Événements Webhook
candidate.createdNouveau candidat enregistré
candidate.prescreenedLe candidat a complété la présélection
candidate.qualifiedCandidat qualifié par le recruteur
meeting.scheduledEntretien programmé
meeting.completedEntretien terminé
Exemple de Code
// Exemple : Obtenir la liste des candidats
const response = await fetch('https://api.cumino.com/v1/candidates', {
headers: {
'Authorization': 'Bearer YOUR_JWT_TOKEN',
'Content-Type': 'application/json'
}
});
const { data: candidates } = await response.json();
console.log(candidates);Documentation Complète
La documentation API complète avec des exemples interactifs sera disponible lors du lancement officiel de Cumino. En attendant, contactez le support pour un accès anticipé au bac à sable.
Besoin d'assistance ?
Notre équipe technique peut vous accompagner dans l'intégration.