Lettere di Presentazione
Crea, genera e renderizza lettere di presentazione.
curl https://api.laddro.com/v1/cover-letters \
-H "x-api-key: YOUR_API_KEY"
{
"data": [
{
"id": "cl_abc123",
"title": "Cover Letter for Acme Corp",
"createdAt": "2026-05-01T10:00:00Z"
}
]
}
GET /v1/cover-letters/{coverLetterId}
| Parametro | Tipo | Posizione | Descrizione |
|---|
coverLetterId | string | path | ID della lettera di presentazione |
{
"data": {
"id": "cl_abc123",
"title": "Cover Letter for Acme Corp",
"content": "Dear Hiring Manager,\n\n...",
"resumeId": "res_abc123",
"templateId": "graphite"
}
}
Crea una lettera di presentazione manualmente con il tuo contenuto.
| Campo | Tipo | Obbligatorio | Descrizione |
|---|
title | string | Si | Titolo della lettera di presentazione |
content | string | Si | Testo della lettera di presentazione |
resumeId | string | No | ID del CV associato |
curl https://api.laddro.com/v1/cover-letters \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Cover Letter for Acme Corp",
"content": "Dear Hiring Manager,\n\nI am writing to..."
}'
POST /v1/cover-letters/generate
Lettera di presentazione generata dall'AI basata su un CV e una descrizione del lavoro. Supporta lo streaming SSE.
| Campo | Tipo | Obbligatorio | Descrizione |
|---|
resumeId | string | Si | CV su cui basare la lettera |
jobDescription | string | Si | Testo o URL della descrizione del lavoro |
curl https://api.laddro.com/v1/cover-letters/generate \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"resumeId": "res_abc123",
"jobDescription": "We are hiring a..."
}'
curl https://api.laddro.com/v1/cover-letters/generate \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: text/event-stream" \
-d '{
"resumeId": "res_abc123",
"jobDescription": "We are hiring a..."
}'
| Stato | Descrizione |
|---|
400 | Campi obbligatori mancanti |
401 | Chiave API mancante o non valida |
402 | Crediti esauriti |
404 | CV non trovato |
PUT /v1/cover-letters/{coverLetterId}/render
| Parametro | Tipo | Posizione | Descrizione |
|---|
coverLetterId | string | path | ID della lettera di presentazione |
templateId | string | body | Template da utilizzare |
curl https://api.laddro.com/v1/cover-letters/cl_abc123/render \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "templateId": "graphite" }' \
--output cover-letter.pdf
Restituisce dati binari application/pdf.
