Mua Email (API)

1. Tổng quan

• API này dùng để mua email theo variant_id.
• variant_id đã hiển thị sẵn trên website (trang mua Email), nên không cần API stock.
• Khi mua thành công, API trả về danh sách mail gồm: email, password, refresh_token, client_id (và có thể có recovery_email, twofa_secret nếu tồn tại).

Tip: Bạn chỉ cần lấy variant_id từ UI “Mua Email” trên website, rồi gọi API Buy là xong.

2. Endpoint & Authentication

Header

Content-Type: application/json
X-API-KEY: YOUR_API_KEY

3. API: Buy mail

Lấy variant_id trực tiếp trên website (UI). Gọi API để mua và nhận thông tin mail đầy đủ.

POST https://minisoftwares.net/api_mail/api_mail_buy.php
Header: X-API-KEY: YOUR_API_KEY
Body (JSON):
{
  "variant_id": 12,
  "qty": 1
}

Tham số

Response thành công (có refresh_token + client_id)

{
  "ok": true,
  "variant_id": 12,
  "qty": 1,
  "unit_price": 20000,
  "total_price": 20000,
  "currency": "VND",
  "provider": "hotmail",
  "mail_type": "long",
  "region": "VN",
  "items": [
    {
      "inventory_id": 12345,
      "order_id": 9001,
      "mailbox_id": 7001,
      "email": "abc@hotmail.com",
      "password": "pass123",
      "refresh_token": "...",
      "client_id": "...",
      "tenant": "consumers",
      "provider": "hotmail",
      "region": "VN",
      "mail_type": "long",
      "expires_at": "2025-12-31 23:59:59",
      "recovery_email": "recovery@example.com",
      "twofa_secret": "JBSWY3DPEHPK3PXP"
    }
  ]
}

4. Live Test

Nhập API key → nhập variant_id (lấy từ UI) → Buy.

// ...

// ...

5. Notes & Error Codes

5.1 Format lỗi

{
  "ok": false,
  "error": "OUT_OF_STOCK",
  "message": "..."
}

5.2 Bảo mật

• Luôn dùng HTTPS
• Lưu API key an toàn, không hardcode public
• Không public response chứa refresh_token/client_id ra log/analytics
• Nếu cần: giới hạn IP / rate limit theo API key

5.3 Một số mã lỗi thường gặp

• OUT_OF_STOCK (409): Hết mail theo variant.
• INSUFFICIENT_FUNDS (402): Không đủ tiền ví.
• VARIANT_NOT_FOUND (404): Variant không tồn tại.
• VARIANT_INACTIVE (403): Variant bị tắt.
• INVALID_JSON (400): Body không phải JSON hợp lệ.
• UNAUTHORIZED (401): Thiếu hoặc sai API key.
• ERROR (500): Lỗi hệ thống (vd thiếu refresh_token/client_id trong kho).