API, kirjakooste ja saatmine e-postiga

Saada kirju otse oma tarkvarast – REST API kaudu, kirjakoostena või lihtsalt e-postiga. Claude’i konnektor kasutab samu funktsioone.

Autentimine

Loo võti jaotises Konto → API-võtmed ja saada see bearer-tokenina. Iga päring arvestatakse ainult selle konto saldost.

curl -H "Authorization: Bearer mbx_…" https://mcpbrief.de/api/v1/balance

OpenAPI kirjeldus: https://mcpbrief.de/openapi.json

Lõpp-punktid

GET	/balance	Saldo, hinnad, saatja, päevalimiit
POST	/letter/price	Kontrolli aadressi, koosta kiri, leheküljed ja hind + PDF-eelvaade (midagi ei saadeta)
POST	/letter/send	Saada kiri (tekst, PDF, DOCX, pilt; lisad, dupleks, kulukoht)
GET	/letter/{id}	Olek ja jälgimisnumber
POST	/letter/{id}/cancel	Tühista enne printimist (hüvitis)
POST	/letter/{id}/resend	Saada uuesti
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Sinu kirjade loend, filtreeritav
POST	/letters/batch/price	Kontrolli kirjakoostet: kõik aadressid, kohatäited, koguhind
POST	/letters/batch/send	Saada kirjakooste (max 200 saajat)

Näide: tähitud kiri koos lisaga

curl -X POST https://mcpbrief.de/api/v1/letter/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipient": {"name": "Muster GmbH", "street": "Ringstraße 5",
                "zip": "1010", "city": "Wien", "country": "AT"},
  "subject": "Rechnung 2026-17",
  "content": "Sehr geehrte Damen und Herren,\n\nanbei …",
  "attachments": [{"file_base64": "JVBERi0…", "file_name": "rechnung.pdf"}],
  "delivery": "registered", "duplex": true, "cost_center": "VERTRIEB",
  "idempotency_key": "7d1c2f0e-…"
}'

Näide: kirjakooste

curl -X POST https://mcpbrief.de/api/v1/letters/batch/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipients": [
    {"name": "Muster GmbH", "street": "Ringstraße 5", "zip": "1010",
     "city": "Wien", "country": "AT", "anrede": "Sehr geehrte Frau Huber"},
    {"name": "Beispiel AG", "street": "Hauptstraße 1", "zip": "10115",
     "city": "Berlin", "country": "DE", "anrede": "Sehr geehrte Damen und Herren"}
  ],
  "subject": "Preisanpassung 2027",
  "content": "{{anrede}},\n\nab 1. Jänner gelten neue Preise …",
  "delivery": "standard", "idempotency_key": "batch-2027-01"
}'

Kirjad e-postiga

Programmeerimist pole vaja: igal kontol on isiklik tellimisaadress. PDF-id, mille saadad sellele aadressile oma konto e-postilt, lähevad teele kirjadena.

Iga PDF-manus = üks kiri, aadress aknaalas (DIN 5008)
Teema määrab valikud: Registered, Priority, Colour, Duplex, Ref: …, Country: …
„Enclosure“ teemas: kõik failid ühendatakse üheks kirjaks
„Test“ teemas: ainult kontroll ja hind e-postiga – midagi ei saadeta

Olekuväärtused

Oleku lõpp-punkt, loend ja e-posti teavitus näitavad hetkeolekut.

`pending`	järjekorras
`processing`	printimisel ja ümbrikku panekul
`mailed`	postiteenusele üle antud
`failed`	saatmata
`cancelled`	tühistatud
`undeliverable`	kättetoimetamatu
`rejected`	tagasi lükatud