Passa al contenuto principale

Guida Introduttiva

La tua prima risposta API in meno di 10 minuti. Questa guida copre l'autenticazione e una chiamata minima usando il flusso M2M (client credentials / B2B).

Prerequisiti​

  • Client ID e Client Secret — rilasciati dal tuo amministratore BeTalent
  • Tenant ID — UUID che identifica la tua organizzazione
  • Cognito Token URL — fornito dal tuo amministratore BeTalent

Passo 1 — Ottenere un Token JWT​

curl -X POST "<COGNITO_TOKEN_URL>" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=<CLIENT_ID>&client_secret=<CLIENT_SECRET>"
{
  "access_token": "eyJ...",
  "token_type": "Bearer",
  "expires_in": 28800
}

Il token è valido per 8 ore. Riutilizzalo per tutte le richieste successive.

Passo 2 — Analizzare un CV (Screen)​

Il flusso è asincrono: carichi il CV e recuperi il risultato tramite invocationId.

Caricare il CV​

curl -X POST "<API_BASE_URL>/cv-screening/upload/" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -F "file=@cv.pdf" \
  -F "tenantId=<TENANT_ID>"
{ "invocationId": "abc-123-..." }

Recuperare il Risultato​

curl -X GET "<API_BASE_URL>/cv-screening/profiles/?invocationId=<INVOCATION_ID>" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "tenantId: <TENANT_ID>"

Ripeti la chiamata finché la risposta non contiene il profilo strutturato.

Passo 3 — Trovare Profili per una Posizione (Match)​

Il flusso Match è sincrono: invii i criteri e ricevi immediatamente i profili classificati.

curl -X GET "<API_BASE_URL>/direct-search" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -G \
  --data-urlencode "tenantId=<TENANT_ID>" \
  --data-urlencode "query=<JOB_DESCRIPTION>" \
  --data-urlencode "scoresOrder=DESC"
{
  "profiles": [
    { "id": "...", "score": 0.97, "name": "..." }
  ]
}

Prossimi Passi​