CV
CV
Gestisci i CV: elenca, recupera, analizza da file e renderizza in PDF.
Elenca i CV
GET /v1/resumesRestituisce tutti i CV appartenenti all'utente autenticato.
Richiesta
curl https://api.laddro.com/v1/resumes \
-H "x-api-key: YOUR_API_KEY"Risposta
{
"data": [
{
"id": "res_abc123",
"title": "Software Engineer Resume",
"createdAt": "2026-05-01T10:00:00Z",
"updatedAt": "2026-05-02T15:30:00Z"
}
]
}Ottieni un CV
GET /v1/resumes/{resumeId}Restituisce i dati completi del CV incluse tutte le sezioni.
Parametri
| Parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
resumeId | string | path | ID del CV |
Richiesta
curl https://api.laddro.com/v1/resumes/res_abc123 \
-H "x-api-key: YOUR_API_KEY"Risposta
{
"data": {
"id": "res_abc123",
"title": "Software Engineer Resume",
"sections": {
"header": {
"name": "Jane Smith",
"email": "[email protected]",
"phone": "+49 170 1234567",
"location": "Berlin, Germany"
},
"summary": "Experienced software engineer...",
"experience": [...],
"education": [...],
"skills": [...],
"languages": [...]
}
}
}Errori
| Stato | Descrizione |
|---|---|
401 | Chiave API mancante o non valida |
404 | CV non trovato |
Analizza un CV
POST /v1/resumes/parseCarica un file PDF o DOCX per estrarre i dati strutturati del CV. Il file viene analizzato tramite AI per identificare sezioni, date e contenuti.
Richiesta
curl https://api.laddro.com/v1/resumes/parse \
-H "x-api-key: YOUR_API_KEY" \
-F "[email protected]"Parametri
| Parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
file | file | form-data | File PDF o DOCX (max 10MB) |
Risposta
{
"data": {
"id": "res_def456",
"title": "Parsed Resume",
"sections": {
"header": { ... },
"summary": "...",
"experience": [...],
"education": [...],
"skills": [...]
}
}
}Errori
| Stato | Descrizione |
|---|---|
400 | Formato file non valido (solo PDF/DOCX) |
401 | Chiave API mancante o non valida |
402 | Crediti esauriti |
413 | File troppo grande (max 10MB) |
Renderizza un CV in PDF
PUT /v1/resumes/{resumeId}/renderRenderizza un CV utilizzando il template specificato e restituisce un file PDF.
Parametri
| Parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
resumeId | string | path | ID del CV |
templateId | string | body | Template da utilizzare (es. graphite) |
fontId | string | body | Font da utilizzare (opzionale) |
Richiesta
curl https://api.laddro.com/v1/resumes/res_abc123/render \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "templateId": "graphite" }' \
--output resume.pdfRisposta
Restituisce dati binari application/pdf.
Errori
| Stato | Descrizione |
|---|---|
401 | Chiave API mancante o non valida |
402 | Crediti esauriti |
404 | CV o template non trovato |