API-Referenz
Technische Dokumentation zur Integration von Cumino in Ihre Systeme. REST-API mit OAuth2-Authentifizierung und Echtzeit-Webhooks.
Basis-URL
Endpoint-Kategorien
Authentifizierung
- OAuth2-Flow
- API-Schlüssel
- JWT-Tokens
- Scopes und Berechtigungen
Kandidaten
- GET /candidates
- POST /candidates
- PUT /candidates/:id
- DELETE /candidates/:id
Kampagnen
- GET /campaigns
- POST /campaigns
- GET /campaigns/:id/leads
- PUT /campaigns/:id/status
Rate Limiting
- 1.000 Anfragen/Minute (Standard)
- 5.000 Anfragen/Minute (Enterprise)
- Antwort-Header
- Retry-After-Unterstützung
Schnellstart
API-Schlüssel erhalten
Registrieren Sie Ihre Anwendung im Cumino-Dashboard und generieren Sie die API-Zugangsdaten.
Authentifizierung
Verwenden Sie die Zugangsdaten, um über den Endpoint /auth/token ein JWT-Token zu erhalten.
Erster Aufruf
Testen Sie die Verbindung mit GET /health und beginnen Sie mit der Nutzung der Endpoints.
Webhooks konfigurieren
Registrieren Sie Ihre Endpoints, um Echtzeit-Benachrichtigungen über Ereignisse zu erhalten.
Webhook-Ereignisse
candidate.createdNeuer Kandidat registriert
candidate.prescreenedKandidat hat das Vorscreening abgeschlossen
candidate.qualifiedKandidat vom Recruiter qualifiziert
meeting.scheduledVorstellungsgespräch geplant
meeting.completedVorstellungsgespräch abgeschlossen
Codebeispiel
// Beispiel: Kandidatenliste abrufen
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);Vollständige Dokumentation
Die vollständige API-Dokumentation mit interaktiven Beispielen wird zum offiziellen Launch von Cumino verfügbar sein. In der Zwischenzeit kontaktieren Sie den Support für einen frühzeitigen Zugang zur Sandbox.
Benötigen Sie Unterstützung?
Unser technisches Team kann Ihnen bei der Integration helfen.