Laddro DocsLaddro Docs

Kaaskirjad

Kaaskirjad

Loo, genereeri ja renderda kaaskirju.

Loetle kaaskirjad

GET /v1/cover-letters

Päring

curl https://api.laddro.com/v1/cover-letters \
  -H "x-api-key: YOUR_API_KEY"

Vastus

{
  "data": [
    {
      "id": "cl_abc123",
      "title": "Cover Letter for Acme Corp",
      "createdAt": "2026-05-01T10:00:00Z"
    }
  ]
}

Hangi kaaskiri

GET /v1/cover-letters/{coverLetterId}

Parameetrid

ParameeterTüüpAsukohtKirjeldus
coverLetterIdstringpathKaaskirja ID

Vastus

{
  "data": {
    "id": "cl_abc123",
    "title": "Cover Letter for Acme Corp",
    "content": "Dear Hiring Manager,\n\n...",
    "resumeId": "res_abc123",
    "templateId": "graphite"
  }
}

Loo kaaskiri

POST /v1/cover-letters

Loo kaaskiri käsitsi oma sisuga.

Päringu keha

VäliTüüpKohustuslikKirjeldus
titlestringJahKaaskirja pealkiri
contentstringJahKaaskirja sisu
resumeIdstringEiSeotud CV ID

Päring

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..."
  }'

Genereeri kaaskiri

POST /v1/cover-letters/generate

AI-genereeritud kaaskiri, mis põhineb CV-l ja töökirjeldusel. Toetab SSE-voogedastust.

Päringu keha

VäliTüüpKohustuslikKirjeldus
resumeIdstringJahCV, millel kiri põhineb
jobDescriptionstringJahTöökirjelduse tekst või URL

Standardpäring

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..."
  }'

Voogedastuspäring

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..."
  }'

Vead

StaatusKirjeldus
400Kohustuslikud väljad puuduvad
401Puuduv või kehtetu API-võti
402Krediite pole alles
404CV-d ei leitud

Renderda kaaskiri PDF-iks

PUT /v1/cover-letters/{coverLetterId}/render

Parameetrid

ParameeterTüüpAsukohtKirjeldus
coverLetterIdstringpathKaaskirja ID
templateIdstringbodyKasutatav mall

Päring

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

Vastus

Tagastab application/pdf binaarandmed.

On this page