Laddro DocsLaddro Docs

Saatekirjeet

Saatekirjeet

Luo, generoi ja renderoi saatekirjeita.

Listaa saatekirjeet

GET /v1/cover-letters

Pyynto

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

Vastaus

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

Hae saatekirje

GET /v1/cover-letters/{coverLetterId}

Parametrit

ParametriTyyppiSijaintiKuvaus
coverLetterIdstringpathSaatekirjeen tunnus

Vastaus

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

Luo saatekirje

POST /v1/cover-letters

Luo saatekirje kasittain omalla sisallollasi.

Pyyntorunko

KenttaTyyppiPakollinenKuvaus
titlestringKyllaSaatekirjeen otsikko
contentstringKyllaSaatekirjeen teksti
resumeIdstringEiLiitetyn ansioluettelon tunnus

Pyynto

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

Generoi saatekirje

POST /v1/cover-letters/generate

Tekoalyn generoima saatekirje ansioluettelon ja tyonkuvauksen perusteella. Tukee SSE-striimausta.

Pyyntorunko

KenttaTyyppiPakollinenKuvaus
resumeIdstringKyllaAnsioluettelo, johon kirje perustuu
jobDescriptionstringKyllaTyonkuvauksen teksti tai URL

Vakiopyynto

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

Striimauspyynto

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

Virheet

TilaKuvaus
400Pakolliset kentat puuttuvat
401API-avain puuttuu tai on virheellinen
402Krediitteja ei jaljella
404Ansioluetteloa ei loydy

Renderoi saatekirje PDF:ksi

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

Parametrit

ParametriTyyppiSijaintiKuvaus
coverLetterIdstringpathSaatekirjeen tunnus
templateIdstringbodyKaytettava malli

Pyynto

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

Vastaus

Palauttaa application/pdf-binaaridatan.

On this page