Cumino
Risorse

API Reference

Documentazione tecnica per integrare Cumino nei tuoi sistemi. REST API con autenticazione OAuth2 e webhooks in tempo reale.

Base URL

# Base URL
https://api.cuminohr.com/v1

Endpoint Categories

Autenticazione

  • OAuth2 flow
  • API Keys
  • JWT tokens
  • Scopes e permessi

Candidati

  • GET /candidates
  • POST /candidates
  • PUT /candidates/:id
  • DELETE /candidates/:id

Campagne

  • 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

1

Ottieni API Key

Registra la tua applicazione nella dashboard Cumino e genera le credenziali API.

2

Autenticazione

Usa le credenziali per ottenere un token JWT tramite l'endpoint /auth/token.

3

Prima chiamata

Testa la connessione con GET /health e inizia a usare gli endpoint.

4

Configura Webhooks

Registra i tuoi endpoint per ricevere notifiche in tempo reale sugli eventi.

Webhook Events

candidate.created

Nuovo candidato registrato

candidate.prescreened

Candidato ha completato il pre-screening

candidate.qualified

Candidato qualificato dal recruiter

meeting.scheduled

Colloquio programmato

meeting.completed

Colloquio completato

Esempio di Codice

// Esempio: Ottenere lista candidati
const response = await fetch('https://api.cuminohr.com/v1/candidates', {
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
    'Content-Type': 'application/json'
  }
});

const { data: candidates } = await response.json();
console.log(candidates);

Prossimi Passi

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.

Contatta Supporto

API Stats

Uptime99.9%
Latenza media<100ms
Endpoints25+

Altre risorse

BlogGuide ESCO