API, μαζική επιστολή & αποστολή μέσω email

Στείλτε επιστολές απευθείας από το λογισμικό σας – μέσω REST API, ως μαζική επιστολή ή απλώς μέσω email. Ο connector του Claude χρησιμοποιεί τις ίδιες λειτουργίες.

Έλεγχος ταυτότητας

Δημιουργήστε ένα κλειδί στην ενότητα Λογαριασμός → Κλειδιά API και στείλτε το ως bearer token. Κάθε αίτημα χρεώνει μόνο το υπόλοιπο του συγκεκριμένου λογαριασμού.

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

Περιγραφή OpenAPI: https://mcpbrief.de/openapi.json

Endpoints

GET	/balance	Υπόλοιπο, τιμές, αποστολέας, ημερήσιο όριο
POST	/letter/price	Έλεγχος διεύθυνσης, δημιουργία επιστολής, σελίδες και τιμή + προεπισκόπηση PDF (δεν στέλνει τίποτα)
POST	/letter/send	Αποστολή επιστολής (κείμενο, PDF, DOCX, εικόνα· συνημμένα, διπλή όψη, κέντρο κόστους)
GET	/letter/{id}	Κατάσταση και αριθμός παρακολούθησης
POST	/letter/{id}/cancel	Ακύρωση πριν από την εκτύπωση (επιστροφή ποσού)
POST	/letter/{id}/resend	Επανάληψη αποστολής
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Λίστα των επιστολών σας, με φίλτρα
POST	/letters/batch/price	Έλεγχος μαζικής επιστολής: όλες οι διευθύνσεις, πεδία, συνολική τιμή
POST	/letters/batch/send	Αποστολή μαζικής επιστολής (έως 200 παραλήπτες)

Παράδειγμα: συστημένη με συνημμένο

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

Παράδειγμα: μαζική επιστολή

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

Επιστολές μέσω email

Χωρίς προγραμματισμό: κάθε λογαριασμός έχει προσωπική διεύθυνση παραγγελιών. Τα PDF που στέλνετε από το email του λογαριασμού σας σε αυτή τη διεύθυνση αποστέλλονται ως επιστολές.

Κάθε συνημμένο PDF = μία επιστολή, διεύθυνση στην περιοχή του παραθύρου (DIN 5008)
Το θέμα ορίζει τις επιλογές: Registered, Priority, Colour, Duplex, Ref: …, Country: …
«Enclosure» στο θέμα: όλα τα αρχεία συνδυάζονται σε μία επιστολή
«Test» στο θέμα: μόνο έλεγχος και τιμή μέσω email – δεν αποστέλλεται τίποτα

Τιμές κατάστασης

Το endpoint κατάστασης, η λίστα και η ειδοποίηση μέσω email δείχνουν την τρέχουσα κατάσταση.

`pending`	σε αναμονή
`processing`	εκτύπωση & φακέλωμα
`mailed`	παραδόθηκε στο ταχυδρομείο
`failed`	δεν στάλθηκε
`cancelled`	ακυρώθηκε
`undeliverable`	αδύνατη επίδοση
`rejected`	απορρίφθηκε