API VookMail dla programistów

Twórz tymczasowe skrzynki i czytaj wiadomości we własnych aplikacjach dzięki prostemu API REST. Odpowiedzi są w formacie JSON.

Uwierzytelnianie

Wysyłaj klucz API w nagłówku Authorization. Klucze wydaje właściciel serwisu.

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

Punkty końcowe

Bazowy adres URL: https://www.vookmail.com/api/v1

Metoda	Ścieżka	Opis
GET	/domains	Wyświetl dostępne domeny
POST	/mailboxes	Utwórz skrzynkę. Treść żądania: nazwa użytkownika i domena, oba pola opcjonalne
GET	/mailboxes/{address}	Szczegóły skrzynki i czas wygaśnięcia
POST	/mailboxes/{address}/extend	Przedłuż czas życia skrzynki
DELETE	/mailboxes/{address}	Zamknij skrzynkę i usuń jej wiadomości
GET	/mailboxes/{address}/messages?after={id}	Wyświetl wiadomości wraz z wykrytymi kodami i linkami
GET	/mailboxes/{address}/messages/{id}	Odczytaj jedną wiadomość: oczyszczony HTML, tekst i załączniki
DELETE	/mailboxes/{address}/messages/{id}	Usuń jedną wiadomość
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	Pobierz załącznik

Przykład

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

Błędy i limity

Błędy zwracają status HTTP wraz z polami error.code i error.message. Każdy klucz ma limit zapytań na minutę, a jego przekroczenie zwraca status 429.