API Reference
Documentazione tecnica per integrare Cumino nei tuoi sistemi. REST API con autenticazione OAuth2 e webhooks in tempo reale.
Base URL
Endpoint Categories
Autenticazione
- OAuth2 flow
- API Keys
- JWT tokens
- Scopes e permessi
Candidatos
- GET /candidates
- POST /candidates
- PUT /candidates/:id
- DELETE /candidates/:id
Campañas
- GET /campaigns
- POST /campaigns
- GET /campaigns/:id/leads
- PUT /campaigns/:id/status
Rate Limiting
- 1000 req/minuto (standard)
- 5000 req/minuto (enterprise)
- Headers di risposta
- Retry-After support
Quick Start
Ottieni API Key
Registra la tua applicazione nella dashboard Cumino e genera le credenziali API.
Autenticazione
Usa le credenziali per ottenere un token JWT tramite l'endpoint /auth/token.
Prima chiamata
Testa la connessione con GET /health e inizia a usare gli endpoint.
Configura Webhooks
Registra i tuoi endpoint per ricevere notifiche in tempo reale sugli eventi.
Webhook Events
candidate.createdNuovo candidato registrato
candidate.prescreenedCandidato ha completato il pre-screening
candidate.qualifiedCandidato qualificato dal recruiter
meeting.scheduledColloquio programmato
meeting.completedEntrevista completada
Esempio di Codice
// Esempio: Ottenere lista candidati
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);Documentazione Completa
La documentazione API completa con esempi interattivi sarà disponibile al lancio ufficiale di Cumino. Nel frattempo, contatta il supporto per accesso anticipato alla sandbox.
Hai bisogno di supporto?
Il nostro team tecnico può aiutarti con l'integrazione.