Cartas de Apresentacao
Criar, gerar e renderizar cartas de apresentacao.
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 | Localizacao | Descricao |
|---|
coverLetterId | string | path | ID da carta de apresentacao |
{
"data": {
"id": "cl_abc123",
"title": "Cover Letter for Acme Corp",
"content": "Dear Hiring Manager,\n\n...",
"resumeId": "res_abc123",
"templateId": "graphite"
}
}
Crie uma carta de apresentacao manualmente com o seu proprio conteudo.
| Campo | Tipo | Obrigatorio | Descricao |
|---|
title | string | Sim | Titulo da carta de apresentacao |
content | string | Sim | Texto da carta de apresentacao |
resumeId | string | Nao | ID do curriculo associado |
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
Carta de apresentacao gerada por IA com base num curriculo e descricao de emprego. Suporta streaming SSE.
| Campo | Tipo | Obrigatorio | Descricao |
|---|
resumeId | string | Sim | Curriculo no qual basear a carta |
jobDescription | string | Sim | Texto ou URL da descricao de emprego |
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..."
}'
| Estado | Descricao |
|---|
400 | Campos obrigatorios em falta |
401 | Chave API em falta ou invalida |
402 | Sem creditos restantes |
404 | Curriculo nao encontrado |
PUT /v1/cover-letters/{coverLetterId}/render
| Parametro | Tipo | Localizacao | Descricao |
|---|
coverLetterId | string | path | ID da carta de apresentacao |
templateId | string | body | Modelo a utilizar |
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
Devolve dados binarios application/pdf.
