API, körlevél és e-mailes küldés

Küldjön leveleket közvetlenül a szoftveréből – REST API-n keresztül, körlevélként vagy egyszerűen e-mailben. A Claude connector ugyanezeket a funkciókat használja.

Hitelesítés

Hozzon létre kulcsot a Fiók → API-kulcsok menüben, és küldje bearer tokenként. Minden kérés csak az adott fiók egyenlegét terheli.

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

OpenAPI-leírás: https://mcpbrief.de/openapi.json

Végpontok

GET	/balance	Egyenleg, árak, feladó, napi limit
POST	/letter/price	Cím ellenőrzése, levél összeállítása, oldalak és ár + PDF-előnézet (nem küld el semmit)
POST	/letter/send	Levél küldése (szöveg, PDF, DOCX, kép; mellékletek, duplex, költséghely)
GET	/letter/{id}	Állapot és nyomkövetési szám
POST	/letter/{id}/cancel	Lemondás nyomtatás előtt (visszatérítés)
POST	/letter/{id}/resend	Újraküldés
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Leveleinek listája, szűrhető
POST	/letters/batch/price	Körlevél ellenőrzése: minden cím, helyőrzők, teljes ár
POST	/letters/batch/send	Körlevél küldése (max. 200 címzett)

Példa: ajánlott levél melléklettel

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

Példa: körlevél

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

Levelek e-mailben

Nincs szükség programozásra: minden fiókhoz tartozik egy személyes megrendelési cím. Azokat a PDF-eket, amelyeket a fiókja e-mail-címéről erre a címre küld, levélként adjuk fel.

Minden PDF-melléklet = egy levél, a cím az ablakos részben (DIN 5008)
A tárgysor vezérli a beállításokat: Ajánlott, Elsőbbségi, Színes, Duplex, Hiv: …, Ország: …
„Melléklet” a tárgysorban: minden fájlt egy levélbe fűzünk
„Teszt” a tárgysorban: csak ellenőrzés, az árat e-mailben kapja meg – semmi sem kerül elküldésre

Állapotértékek

Az állapot-végpont, a lista és az e-mailes értesítés az aktuális állapotot mutatja.

`pending`	sorban áll
`processing`	nyomtatás és borítékolás
`mailed`	átadva a postának
`failed`	nem került elküldésre
`cancelled`	lemondva
`undeliverable`	kézbesíthetetlen
`rejected`	elutasítva