Saatekirjeet
Luo, generoi ja renderoi saatekirjeita.
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}
| Parametri | Tyyppi | Sijainti | Kuvaus |
|---|
coverLetterId | string | path | Saatekirjeen tunnus |
{
"data": {
"id": "cl_abc123",
"title": "Cover Letter for Acme Corp",
"content": "Dear Hiring Manager,\n\n...",
"resumeId": "res_abc123",
"templateId": "graphite"
}
}
Luo saatekirje kasittain omalla sisallollasi.
| Kentta | Tyyppi | Pakollinen | Kuvaus |
|---|
title | string | Kylla | Saatekirjeen otsikko |
content | string | Kylla | Saatekirjeen teksti |
resumeId | string | Ei | Liitetyn ansioluettelon tunnus |
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
Tekoalyn generoima saatekirje ansioluettelon ja tyonkuvauksen perusteella. Tukee SSE-striimausta.
| Kentta | Tyyppi | Pakollinen | Kuvaus |
|---|
resumeId | string | Kylla | Ansioluettelo, johon kirje perustuu |
jobDescription | string | Kylla | Tyonkuvauksen teksti tai URL |
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..."
}'
| Tila | Kuvaus |
|---|
400 | Pakolliset kentat puuttuvat |
401 | API-avain puuttuu tai on virheellinen |
402 | Krediitteja ei jaljella |
404 | Ansioluetteloa ei loydy |
PUT /v1/cover-letters/{coverLetterId}/render
| Parametri | Tyyppi | Sijainti | Kuvaus |
|---|
coverLetterId | string | path | Saatekirjeen tunnus |
templateId | string | body | Kaytettava malli |
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
Palauttaa application/pdf-binaaridatan.