VookMail fejlesztői API

Hozz létre ideiglenes postaládákat és olvass üzeneteket a saját alkalmazásaidból egy egyszerű REST API-val. A válaszok JSON formátumúak.

Hitelesítés

Küldd el az API-kulcsodat az Authorization fejlécben. A kulcsokat az oldal tulajdonosa adja ki.

curl https://www.vookmail.com/api/v1/domains \
  -H "Authorization: Bearer vk_your_key"

Végpontok

Alap URL: https://www.vookmail.com/api/v1

Metódus	Útvonal	Leírás
GET	/domains	Az elérhető domainek listázása
POST	/mailboxes	Postaláda létrehozása. Törzs: felhasználónév és domain, mindkettő elhagyható
GET	/mailboxes/{address}	A postaláda adatai és lejárata
POST	/mailboxes/{address}/extend	A postaláda élettartamának meghosszabbítása
DELETE	/mailboxes/{address}	A postaláda bezárása és az üzenetek törlése
GET	/mailboxes/{address}/messages?after={id}	Üzenetek listázása a felismert kódokkal és linkekkel
GET	/mailboxes/{address}/messages/{id}	Egy üzenet olvasása: megtisztított HTML, szöveg és mellékletek
DELETE	/mailboxes/{address}/messages/{id}	Egy üzenet törlése
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	Melléklet letöltése

Példa

curl -X POST https://www.vookmail.com/api/v1/mailboxes \
  -H "Authorization: Bearer vk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"username":"myapp"}'

{"address":"myapp@example.com","token":"...","expires_at":"2026-10-31T12:00:00+00:00"}

Hibák és korlátok

A hibák HTTP-állapotkódot adnak vissza error.code és error.message mezőkkel. Minden kulcsnak percenként korlátja van; ennek túllépése a 429-es állapotot adja vissza.