Referencia da API

URL base para todos os endpoints:

https://api.laddro.com/v1

Para um explorador interativo da API, visite api.laddro.com/reference.

Visao Geral dos Endpoints

Metodo	Endpoint	Descricao
`GET`	`/v1/templates`	Listar todos os modelos de curriculo
`GET`	`/v1/templates/{templateId}`	Obter detalhes de um modelo
`GET`	`/v1/fonts`	Listar tipos de letra disponiveis
`GET`	`/v1/languages`	Listar idiomas suportados
`GET`	`/v1/models`	Listar modelos de IA disponiveis

Metodo	Endpoint	Descricao
`GET`	`/v1/resumes`	Listar os seus curriculos
`GET`	`/v1/resumes/{resumeId}`	Obter um curriculo especifico
`POST`	`/v1/resumes/parse`	Analisar um curriculo PDF/DOCX
`PUT`	`/v1/resumes/{resumeId}/render`	Renderizar curriculo para PDF
`POST`	`/v1/tailor`	Personalizar curriculo para um emprego (SSE)
`POST`	`/v1/export`	Exportar curriculo como PDF
`GET`	`/v1/cover-letters`	Listar cartas de apresentacao
`GET`	`/v1/cover-letters/{coverLetterId}`	Obter uma carta de apresentacao
`POST`	`/v1/cover-letters`	Criar uma carta de apresentacao
`POST`	`/v1/cover-letters/generate`	Gerar carta de apresentacao (SSE)
`PUT`	`/v1/cover-letters/{coverLetterId}/render`	Renderizar carta de apresentacao para PDF
`GET`	`/v1/settings`	Obter definicoes de IA atuais
`PUT`	`/v1/settings/model`	Definir modelo de IA (BYOK)
`DELETE`	`/v1/settings/model`	Repor modelo predefinido

Todas as respostas devolvem JSON com codigos de estado HTTP adequados:

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

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

Consulte Codigos de Erro para a referencia completa.

Corpos de pedido: application/json (exceto uploads de ficheiros que utilizam multipart/form-data)
Respostas PDF: application/pdf
Streams SSE: text/event-stream