Curriculos
Curriculos
Gerir curriculos: listar, obter, analisar a partir de ficheiros e renderizar para PDF.
Listar Curriculos
GET /v1/resumesDevolve todos os curriculos pertencentes ao utilizador autenticado.
Pedido
curl https://api.laddro.com/v1/resumes \
-H "x-api-key: YOUR_API_KEY"Resposta
{
"data": [
{
"id": "res_abc123",
"title": "Software Engineer Resume",
"createdAt": "2026-05-01T10:00:00Z",
"updatedAt": "2026-05-02T15:30:00Z"
}
]
}Obter Curriculo
GET /v1/resumes/{resumeId}Devolve os dados completos do curriculo, incluindo todas as seccoes.
Parametros
| Parametro | Tipo | Localizacao | Descricao |
|---|---|---|---|
resumeId | string | path | ID do curriculo |
Pedido
curl https://api.laddro.com/v1/resumes/res_abc123 \
-H "x-api-key: YOUR_API_KEY"Resposta
{
"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": [...]
}
}
}Erros
| Estado | Descricao |
|---|---|
401 | Chave API em falta ou invalida |
404 | Curriculo nao encontrado |
Analisar Curriculo
POST /v1/resumes/parseCarregue um ficheiro PDF ou DOCX para extrair dados estruturados do curriculo. O ficheiro e analisado com IA para identificar seccoes, datas e conteudo.
Pedido
curl https://api.laddro.com/v1/resumes/parse \
-H "x-api-key: YOUR_API_KEY" \
-F "[email protected]"Parametros
| Parametro | Tipo | Localizacao | Descricao |
|---|---|---|---|
file | file | form-data | Ficheiro PDF ou DOCX (max 10MB) |
Resposta
{
"data": {
"id": "res_def456",
"title": "Parsed Resume",
"sections": {
"header": { ... },
"summary": "...",
"experience": [...],
"education": [...],
"skills": [...]
}
}
}Erros
| Estado | Descricao |
|---|---|
400 | Formato de ficheiro invalido (apenas PDF/DOCX) |
401 | Chave API em falta ou invalida |
402 | Sem creditos restantes |
413 | Ficheiro demasiado grande (max 10MB) |
Renderizar Curriculo para PDF
PUT /v1/resumes/{resumeId}/renderRenderiza um curriculo utilizando o modelo especificado e devolve um ficheiro PDF.
Parametros
| Parametro | Tipo | Localizacao | Descricao |
|---|---|---|---|
resumeId | string | path | ID do curriculo |
templateId | string | body | Modelo a utilizar (ex.: graphite) |
fontId | string | body | Tipo de letra a utilizar (opcional) |
Pedido
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.pdfResposta
Devolve dados binarios application/pdf.
Erros
| Estado | Descricao |
|---|---|
401 | Chave API em falta ou invalida |
402 | Sem creditos restantes |
404 | Curriculo ou modelo nao encontrado |