VookMail Geliştirici API'si

Basit bir REST API ile kendi uygulamalarınızdan geçici gelen kutuları oluşturun ve iletileri okuyun. Yanıtlar JSON biçimindedir.

Kimlik doğrulama

API anahtarınızı Authorization başlığında gönderin. Anahtarları site sahibi verir.

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

Uç noktalar

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

Yöntem	Yol	Açıklama
GET	/domains	Kullanılabilir alan adlarını listeler
POST	/mailboxes	Posta kutusu oluşturur. Gövde: kullanıcı adı ve alan adı, ikisi de isteğe bağlı
GET	/mailboxes/{address}	Posta kutusu ayrıntıları ve bitiş süresi
POST	/mailboxes/{address}/extend	Posta kutusunun ömrünü uzat
DELETE	/mailboxes/{address}	Posta kutusunu kapat ve iletilerini sil
GET	/mailboxes/{address}/messages?after={id}	İletileri, algılanan kodlar ve bağlantılarla birlikte listeler
GET	/mailboxes/{address}/messages/{id}	Tek bir iletiyi okur: temizlenmiş HTML, metin ve ekler
DELETE	/mailboxes/{address}/messages/{id}	Tek bir iletiyi sil
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	Bir eki indir

Örnek

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

Hatalar ve sınırlar

Hatalar, error.code ve error.message ile birlikte bir HTTP durumu döndürür. Her anahtarın dakikalık bir sınırı vardır; aşıldığında 429 durumu döner.