API dành cho nhà phát triển của VookMail

Tạo hộp thư tạm thời và đọc thư từ ứng dụng của riêng bạn bằng một REST API đơn giản. Phản hồi ở dạng JSON.

Xác thực

Gửi khóa API của bạn trong tiêu đề Authorization. Khóa do chủ sở hữu trang web cấp.

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

Điểm cuối

URL gốc: https://www.vookmail.com/api/v1

Phương thức	Đường dẫn	Mô tả
GET	/domains	Liệt kê các tên miền có sẵn
POST	/mailboxes	Tạo một hộp thư. Nội dung gửi: tên người dùng và tên miền, đều không bắt buộc
GET	/mailboxes/{address}	Thông tin hộp thư và thời hạn
POST	/mailboxes/{address}/extend	Gia hạn thời gian tồn tại của hộp thư
DELETE	/mailboxes/{address}	Đóng hộp thư và xóa các thư trong đó
GET	/mailboxes/{address}/messages?after={id}	Liệt kê thư, kèm mã và liên kết đã phát hiện
GET	/mailboxes/{address}/messages/{id}	Đọc một thư: HTML đã làm sạch, văn bản và tệp đính kèm
DELETE	/mailboxes/{address}/messages/{id}	Xóa một thư
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	Tải xuống một tệp đính kèm

Ví dụ

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

Lỗi và giới hạn

Khi có lỗi, API trả về một mã trạng thái HTTP kèm error.code và error.message. Mỗi khóa có giới hạn số lần gọi mỗi phút; vượt giới hạn sẽ trả về mã 429.