API, masiniai laiškai ir siuntimas el. paštu

Siųskite laiškus tiesiai iš savo programinės įrangos – per REST API, kaip masinius laiškus arba tiesiog el. paštu. Claude jungtis naudoja tas pačias funkcijas.

Autentifikavimas

Sukurkite raktą skiltyje Paskyra → API raktai ir siųskite jį kaip bearer prieigos raktą. Kiekviena užklausa apmokestina tik tos paskyros balansą.

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

OpenAPI aprašas: https://mcpbrief.de/openapi.json

Galiniai taškai

GET	/balance	Balansas, kainos, siuntėjas, dienos limitas
POST	/letter/price	Patikrinti adresą, sukurti laišką, puslapiai ir kaina + PDF peržiūra (nieko nesiunčia)
POST	/letter/send	Siųsti laišką (tekstas, PDF, DOCX, paveikslėlis; priedai, dvipusis, išlaidų centras)
GET	/letter/{id}	Būsena ir siuntos numeris
POST	/letter/{id}/cancel	Atšaukti iki spausdinimo (grąžinimas)
POST	/letter/{id}/resend	Siųsti dar kartą
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Jūsų laiškų sąrašas su filtrais
POST	/letters/batch/price	Patikrinti masinius laiškus: visi adresai, vietos rezervavimo ženklai, bendra kaina
POST	/letters/batch/send	Siųsti masinius laiškus (daugiausia 200 gavėjų)

Pavyzdys: registruotas laiškas su priedu

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

Pavyzdys: masiniai laiškai

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

Laiškai el. paštu

Programuoti nereikia: kiekviena paskyra turi asmeninį užsakymų adresą. PDF, kuriuos šiuo adresu siunčiate iš savo paskyros el. pašto, išsiunčiami kaip laiškai.

Kiekvienas PDF priedas = vienas laiškas, adresas langelio srityje (DIN 5008)
Tema valdo parinktis: Registered, Priority, Colour, Duplex, Ref: …, Country: …
„Enclosure“ temoje: visi failai sujungiami į vieną laišką
„Test“ temoje: tik patikrinimas ir kaina el. paštu – niekas neišsiunčiama

Būsenos reikšmės

Būsenos galinis taškas, sąrašas ir el. pašto pranešimas rodo dabartinę būseną.

`pending`	eilėje
`processing`	spausdinama ir įvokuojama
`mailed`	perduota paštui
`failed`	neišsiųsta
`cancelled`	atšaukta
`undeliverable`	neįmanoma pristatyti
`rejected`	atmesta