Laddro DocsLaddro Docs

Ottimizzazione

Ottimizzazione

Ottimizzazione del CV basata su AI. Riscrive le sezioni del CV per adattarle a una specifica offerta di lavoro.

Ottimizza un CV

POST /v1/tailor

Invia un CV e una descrizione del lavoro al motore AI, che restituisce suggerimenti personalizzati per ogni sezione del CV. Supporta lo streaming SSE per risposte in tempo reale.

Corpo della Richiesta

CampoTipoObbligatorioDescrizione
resumeIdstringSiID del CV da ottimizzare
jobDescriptionstringSiTesto completo della descrizione del lavoro o URL

Richiesta Standard

curl https://api.laddro.com/v1/tailor \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resumeId": "res_abc123",
    "jobDescription": "We are looking for a Senior Frontend Engineer with 5+ years of React experience..."
  }'

Risposta Standard

{
  "data": {
    "suggestions": {
      "summary": "Senior frontend engineer with 6 years of React expertise...",
      "experience": [
        {
          "index": 0,
          "original": "Built web applications",
          "tailored": "Architected and shipped 3 production React applications serving 50K+ users"
        }
      ],
      "skills": ["React", "TypeScript", "Next.js", "Tailwind CSS"]
    }
  }
}

Richiesta in Streaming (SSE)

Aggiungi Accept: text/event-stream per ricevere i risultati man mano che vengono generati:

curl https://api.laddro.com/v1/tailor \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "resumeId": "res_abc123",
    "jobDescription": "Senior Frontend Engineer..."
  }'

Risposta SSE

data: {"type":"section","section":"summary","content":"Senior frontend..."}

data: {"type":"section","section":"experience","content":"..."}

data: {"type":"done"}

Consulta la Guida allo Streaming per i pattern di implementazione.

Errori

StatoDescrizione
400resumeId o jobDescription mancante
401Chiave API mancante o non valida
402Crediti esauriti
404CV non trovato
422Descrizione del lavoro troppo corta o non valida

On this page