Passa al contenuto principale

Panoramica API Match

Questo documento descrive il flusso funzionale di integrazione con la Match API, un insieme di API REST progettate per elaborare e recuperare profili in base a una posizione lavorativa. Include il flusso di integrazione B2B, l'utilizzo delle API, la logica di elaborazione sincrona e i modelli dati restituiti dal sistema.

Riepilogo del Flusso​

Il flusso Match è sincrono 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. Profili:​

  • Endpoint: GET /direct-search
  • I client recuperano i profili tramite questo endpoint.
  • L'API restituisce una lista di profiles che soddisfano tutti i criteri di input, classificati per punteggio.

Diagramma di Sequenza​

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