Riferimento API

URL base per tutti gli endpoint:

https://api.laddro.com/v1

Per un explorer API interattivo, visita api.laddro.com/reference.

Panoramica degli Endpoint

Metodo	Endpoint	Descrizione
`GET`	`/v1/templates`	Elenca tutti i template per CV
`GET`	`/v1/templates/{templateId}`	Dettagli di un template
`GET`	`/v1/fonts`	Elenca i font disponibili
`GET`	`/v1/languages`	Elenca le lingue supportate
`GET`	`/v1/models`	Elenca i modelli AI disponibili

Metodo	Endpoint	Descrizione
`GET`	`/v1/resumes`	Elenca i tuoi CV
`GET`	`/v1/resumes/{resumeId}`	Ottieni un CV specifico
`POST`	`/v1/resumes/parse`	Analizza un CV PDF/DOCX
`PUT`	`/v1/resumes/{resumeId}/render`	Renderizza un CV in PDF
`POST`	`/v1/tailor`	Ottimizza un CV per un lavoro (SSE)
`POST`	`/v1/export`	Esporta un CV come PDF
`GET`	`/v1/cover-letters`	Elenca le lettere di presentazione
`GET`	`/v1/cover-letters/{coverLetterId}`	Ottieni una lettera di presentazione
`POST`	`/v1/cover-letters`	Crea una lettera di presentazione
`POST`	`/v1/cover-letters/generate`	Genera una lettera di presentazione (SSE)
`PUT`	`/v1/cover-letters/{coverLetterId}/render`	Renderizza una lettera di presentazione in PDF
`GET`	`/v1/settings`	Ottieni le impostazioni AI correnti
`PUT`	`/v1/settings/model`	Imposta il modello AI (BYOK)
`DELETE`	`/v1/settings/model`	Ripristina il modello predefinito

Tutte le risposte restituiscono JSON con i codici di stato HTTP appropriati:

{
  "data": { ... },
  "message": "Success"
}

{
  "error": "Not Found",
  "message": "Resume not found",
  "statusCode": 404
}

Consulta Codici di Errore per un riferimento completo.

Corpo delle richieste: application/json (tranne i caricamenti di file che usano multipart/form-data)
Risposte PDF: application/pdf
Stream SSE: text/event-stream