Panoramica API Screen

Questo documento descrive il flusso funzionale di integrazione con la CV Screening API, un insieme di API REST progettate per elaborare e recuperare dati dai CV. Include il flusso di integrazione B2B, l'utilizzo delle API, la logica di elaborazione asincrona e i modelli dati restituiti dal sistema.

Riepilogo del Flusso

Il flusso di CV Screening è asincrono e progettato per scalare. Include i seguenti passaggi chiave:

1. Autenticazione:

• L'API supporta l'Autenticazione M2M (B2B) per sistemi e integrazioni backend, usando credenziali pre-provisionate (es. client ID e secret) per ottenere un token JWT per l'accesso alle API.
• Il token deve essere incluso nell'header Authorization: Bearer <token> di ogni richiesta.

2. Caricamento CV:

• Endpoint: POST /cv-screening/upload/
• I client inviano i documenti CV tramite questo endpoint.
• L'API restituisce un invocationId che può essere usato per tracciare e recuperare i risultati dell'elaborazione.

3. Elaborazione:

• Il sistema elabora il CV in modo asincrono, includendo:
  • Parsing del CV ed estrazione delle entità.
  • Estrazione della foto dal CV caricato.
• I risultati diventano disponibili per il recupero una volta completata l'elaborazione.

4. Recupero del Risultato:

• Endpoint: GET /cv-screening/profiles/
• I client effettuano polling per i risultati elaborati usando l'invocationId restituito dopo il caricamento.

Diagramma di Sequenza

Il diagramma di sequenza qui sotto mostra come i sistemi esterni interagiscono con la CV Screening API di BeTalent. Dopo l'autenticazione, il client può usare il token JWT per chiamare l'API.