Tài liệu REST API

GET/api/v1/services

Dịch vụ — giá & tồn kho

Không có ?service= → trả cả danh sách. Có ?service= → giá + tồn kho của một dịch vụ. Không cần API key.

Không cần auth

• service (tuỳ chọn) — Bỏ trống = cả danh sách; có mã = một dịch vụ (chấp nhận cả mã trần, ví dụ facebook)

Thành công

{ "status": "success", "data": { "services": [
    { "code": "otp_gmail_facebook", "name": "Facebook", "price": 5000, "stock": 42 }
  ] } }

GET/api/v1/me

Thông tin tài khoản

ID, email và số dư của API key đang gọi.

Cần API key

Thành công

{ "status": "success", "data": { "id": "b7e5...-uuid", "email": "demo@mailsmmo.com", "balance": 1000000, "created_at": "2026-01-15T08:30:00Z" } }

GET/api/v1/orders

Tạo đơn

Một endpoint cho cả hai: service là mã OTP Gmail (otp_gmail_*) → cấp 1 mail OTP; service là mã sản phẩm kho (hotmail_*…) → mua theo quantity. Trừ tiền theo giá.

Cần API key

• service — Mã dịch vụ OTP (otp_gmail_*) hoặc mã sản phẩm kho (vd hotmail_imap_12m_36m)
• quantity (tuỳ chọn) — Chỉ cho email bán đứt — số lượng (mặc định 1)
• unique_key (tuỳ chọn) — UUID tự sinh — gửi lại không tạo/trừ tiền 2 lần

Thành công

{ "status": "success", "data": {
    "id": "b7e5a1c2-3d4e-4f60-8a91-2c3d4e5f6a7b", "email": "zurhansuzu@gmail.com",
    "service": "otp_gmail_facebook", "amount": 5000
  } }

GET/api/v1/orders/otp

Lấy OTP theo đơn

Đọc OTP của một đơn. Không cần API key — mã đơn (order_id) là khóa capability.

Không cần auth

• order_id — Mã đơn (trả về ở bước tạo đơn)
• unique_key (tuỳ chọn) — UUID tự sinh mỗi lần gọi
• from (tuỳ chọn) — Unix giây — bỏ otp/received_at nếu chưa có mã mới hơn

Thành công

{ "status": "success", "data": {
    "otp": "481253", "amount": 5000, "received_at": 1732000000,
    "from": "security@facebookmail.com", "otp_history": [
      { "value": "481253", "received_at": 1732000000 }
    ] } }

GET/api/v1/otp/orders

Danh sách đơn OTP

Đơn Gmail OTP đã thuê, phân trang. Kèm OTP mới nhất của mỗi đơn.

Cần API key

• page (tuỳ chọn) — Trang (mặc định 1)
• page_size (tuỳ chọn) — Số dòng/trang (mặc định 20, tối đa 200)

Thành công

{ "status": "success", "data": { "orders": [
    { "id": "b7e5a1c2-3d4e-4f60-8a91-2c3d4e5f6a7b", "email": "...", "service": "otp_gmail_facebook",
      "latest_otp": "481253", "latest_link": null }
  ], "page": 1, "page_size": 20, "total": 137 } }

GET/api/v1/mail

Đọc toàn bộ thư

Tất cả thư của một mail, kèm OTP/link đã bóc.

Cần API key

• order_id — Mã đơn

Thành công

{ "status": "success", "data": { "count": 1, "messages": [
    { "id": 88, "from": "...", "subject": "...", "otp": "481253", "received_at": "..." }
  ] } }