Dùng API key của tài khoản để lấy mailbox, đọc OTP, theo dõi lịch sử thuê.
http://127.0.0.1:2012Lấy API key tại Hồ sơ. Gửi key trong header X-API-Key hoặc Authorization: Bearer ở mọi request API V1.
curl http://127.0.0.1:2012/api/v1/me \
-H "X-API-Key: mrk_your_api_key"const response = await fetch(
"http://127.0.0.1:2012/api/v1/me",
{ headers: { "X-API-Key": apiKey } }
);
const data = await response.json();/api/v1/meTrả về tên đăng nhập, email, họ tên và số dư xu hiện có.
curl http://127.0.0.1:2012/api/v1/me \
-H "X-API-Key: mrk_your_api_key"{
"user": {
"username": "phatchau036",
"email": "user@example.com",
"full_name": "Phat Chau",
"balance": 5000
}
}/api/v1/mail?mailbox=mail@example.comKhông truyền mailbox để lấy tóm tắt OTP từ các đơn thuê. Truyền mailbox để đọc nội dung mail từ IMAP.
curl "http://127.0.0.1:2012/api/v1/mail?mailbox=mail@example.com" \
-H "Authorization: Bearer mrk_your_api_key"{
"mailbox": "mail@example.com",
"messages": [{
"uid": "42",
"subject": "Your verification code",
"otp": "123456",
"date": "Fri, 22 Aug 2026 ..."
}]
}/api/v1/mailboxesLấy các mailbox thuộc tài khoản hiện tại và thông tin dịch vụ đã dùng.
curl http://127.0.0.1:2012/api/v1/mailboxes \
-H "X-API-Key: mrk_your_api_key"{
"mailboxes": [{
"mailbox": "mail@example.com",
"note": "iCloud OTP",
"created_at": "22/08/2026 08:23"
}]
}/api/v1/mail-history?mailbox=mail@example.comLọc theo một mailbox bằng query mailbox hoặc bỏ query để lấy toàn bộ lịch sử của tài khoản.
curl "http://127.0.0.1:2012/api/v1/mail-history" \
-H "X-API-Key: mrk_your_api_key"{
"history": [{
"mailbox": "mail@example.com",
"service_name": "Facebook",
"status": "completed"
}]
}/api/v1/rentalsTrả về các đơn thuê, trạng thái và OTP nếu đã nhận được.
curl http://127.0.0.1:2012/api/v1/rentals \
-H "X-API-Key: mrk_your_api_key"{
"rentals": [{
"id": 15,
"service": "Facebook",
"email": "mail@example.com",
"otp": "123456",
"status": "completed"
}]
}{ "error": "Valid API key required..." }{ "error": "Mailbox not found or no IMAP source assigned." }