API, sērijveida vēstules un sūtīšana pa e-pastu

Sūtiet vēstules tieši no savas programmatūras – ar REST API, kā sērijveida vēstules vai vienkārši pa e-pastu. Claude savienotājs izmanto tās pašas funkcijas.

Autentifikācija

Izveidojiet atslēgu sadaļā Konts → API atslēgas un nosūtiet to kā bearer token. Katrs pieprasījums tiek iekasēts tikai no attiecīgā konta atlikuma.

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

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

Galapunkti

GET	/balance	Atlikums, cenas, sūtītājs, dienas limits
POST	/letter/price	Pārbaudīt adresi, izveidot vēstuli, lappuses un cenu + PDF priekšskatījums (neko nesūta)
POST	/letter/send	Nosūtīt vēstuli (teksts, PDF, DOCX, attēls; pielikumi, duplekss, izmaksu centrs)
GET	/letter/{id}	Statuss un izsekošanas numurs
POST	/letter/{id}/cancel	Atcelt pirms drukāšanas (atmaksa)
POST	/letter/{id}/resend	Nosūtīt vēlreiz
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Jūsu vēstuļu saraksts, filtrējams
POST	/letters/batch/price	Pārbaudīt sērijveida vēstuli: visas adreses, vietturi, kopējā cena
POST	/letters/batch/send	Nosūtīt sērijveida vēstuli (maks. 200 adresāti)

Piemērs: ierakstīts sūtījums ar pielikumu

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

Piemērs: sērijveida vēstule

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

Vēstules pa e-pastu

Programmēšana nav nepieciešama: katram kontam ir personīga pasūtījumu adrese. PDF, ko nosūtāt no sava konta e-pasta uz šo adresi, tiek nosūtīti kā vēstules.

Katrs PDF pielikums = viena vēstule, adrese lodziņa laukumā (DIN 5008)
Temats nosaka opcijas: Ierakstīts, Prioritārs, Krāsu, Duplekss, Ref: …, Valsts: …
„Pielikums” tematā: visi faili tiek apvienoti vienā vēstulē
„Tests” tematā: tikai pārbaude un cena pa e-pastu – nekas netiek nosūtīts

Statusa vērtības

Statusa galapunkts, saraksts un e-pasta paziņojums parāda pašreizējo stāvokli.

`pending`	rindā
`processing`	drukāšana un ielikšana aploksnē
`mailed`	nodota pastam
`failed`	nav nosūtīta
`cancelled`	atcelta
`undeliverable`	nav piegādājama
`rejected`	noraidīta