API dokumentáció

Email API magyar fejlesztőknek — magyar dashboard, EU adattárolás, egyszerű integráció.

Authentikáció

Minden API kérés Bearer tokent igényel. API kulcsot a dashboardon generálhatsz.

Authorization: Bearer ma_live_xxx

Email küldés

POST /api/v1/emails
Authorization: Bearer ma_live_xxx
Content-Type: application/json

{
  "from": "hello@cegem.hu",
  "from_name": "Cégem",
  "to": "ugyfel@example.com",
  "subject": "Rendelés visszaigazolás",
  "html": "<h1>Köszönjük!</h1>",
  "text": "Köszönjük!",
  "scheduled_at": "2026-04-10T08:00:00Z",
  "tags": { "order_id": "12345" }
}

Endpoint reference

Emailek

POST
/api/v1/emails

Egyedi email küldés (azonnali vagy ütemezett)

POST
/api/v1/emails/batch

Batch küldés, max 100 email/request

GET
/api/v1/emails

Email lista (cursor pagination, status szűrő)

GET
/api/v1/emails/:id

Egyedi email státusz

DELETE
/api/v1/emails/:id

Ütemezett email törlése

Domainek

POST
/api/v1/domains

Küldő domain hozzáadása

GET
/api/v1/domains

Domain lista

GET
/api/v1/domains/:id

Domain részletek + DNS rekordok

POST
/api/v1/domains/:id/verify

Verifikáció ellenőrzése

DELETE
/api/v1/domains/:id

Domain törlése

Inbound domainek

POST
/api/v1/inbound-domains

Fogadó domain hozzáadása

GET
/api/v1/inbound-domains

Lista

POST
/api/v1/inbound-domains/:id/verify

MX rekord ellenőrzés

DELETE
/api/v1/inbound-domains/:id

Törlés

Bejövő emailek

GET
/api/v1/inbound-emails

Bejövő email lista

GET
/api/v1/inbound-emails/:id

Egy bejövő email részletei

GET
/api/v1/inbound-emails/:id/attachments/:index

Csatolmány letöltés

Webhookok

POST
/api/v1/webhooks

Webhook URL beállítás eseményekkel

GET
/api/v1/webhooks

Webhook lista

DELETE
/api/v1/webhooks/:id

Törlés

Webhook payload

A webhook hívások HMAC-SHA256 aláírást kapnak az X-MailAPI-Signature headerben. Az aláírás a {timestamp}.{body} stringből generálódik a webhook secret kulccsal.

POST https://your-app.com/webhooks/mailapi
Content-Type: application/json
X-MailAPI-Event: email.delivered
X-MailAPI-Signature: <hmac-sha256>
X-MailAPI-Timestamp: 1733740800

{
  "event": "email.delivered",
  "timestamp": "2026-04-07T10:00:00Z",
  "data": {
    "email_id": "em_abc123",
    "from": "hello@cegem.hu",
    "to": "ugyfel@example.com",
    "subject": "Rendelés visszaigazolás",
    "tags": { "order_id": "12345" }
  }
}

SMTP Relay

Ha az alkalmazásod SMTP-n küld emailt, használd az alábbi adatokat. A username bármi lehet, a password a teljes API kulcs.

Host:     smtp.mailapi.hu
Port:     587 (STARTTLS) / 465 (TLS)
Username: apikey
Password: ma_live_xxx

Rate limit

100 request / perc / API kulcs. Túllépésnél 429 Too Many Requests.