Kết nối một lần.
Vận hành dài lâu.

Từ API Key đến đơn hàng đầu tiên

Tạo key trực tiếp trong @LungMiuBOT. Không cần gửi key cho admin và không được chia sẻ key cho người khác.

Giữ key như mật khẩu

Mọi request phải gửi API Key trong header. Đại lý đã tạo tài khoản có thể xem lại key trực tiếp trong LungMiuBOT.

X-API-Key: lmb_your_private_key
Content-Type: application/json

Danh mục được đồng bộ liên tục

Danh mục mở gồm tài khoản trong kho, proxy, SOCKS5, Telegram VIP, các dịch vụ giao thủ công được phép, Gemini/YouTube và Key Tool Tele. Thuê SIM và toàn bộ Grok/ChatGPT không hỗ trợ API. Chỉ sản phẩm đang bật được trả về. Giá được cố định khi đơn tạo thành công.

curl "https://api.lungmiubot.shop/v1/catalog"   -H "X-API-Key: lmb_your_private_key"

{
  "items": [{
    "public_code": "proxy_http_SAMPLE",
    "name": "Proxy HTTP IPv4 VN",
    "base_api_price": 20700,
    "price_adjust_percent": -10,
    "api_price": 18630,
    "fulfillment_type": "auto_proxy",
    "input_fields": [],
    "max_quantity": 100,
    "stock": 18,
    "api_enabled": true
  }]
}

Giá theo tài khoản đại lý

Admin có thể tăng hoặc giảm % riêng từng đại lý. base_api_price là giá gốc; price_adjust_percent là mức điều chỉnh của bạn; api_price là đơn giá thực tế được trừ ví. Ví dụ -10%: 100.000đ còn 90.000đ; +10%: thành 110.000đ. Giá làm tròn đến đồng.

Tự tạo key sau khi trừ ví

Gọi POST /v1/orders với mã gói và quantity (1–20). Theo dõi đơn đến completed; kết quả có result.keys (key, expiry, plan). Mỗi key dùng một máy. Đây là cấp key mới theo thời hạn gói; không kéo dài key cũ. Tài khoản API dùng mức % riêng do admin cấu hình.

{"client_order_id":"MYBOT-KEY-001","product_code":"tool_key_1m","quantity":1}

{"item":{"client_order_id":"MYBOT-KEY-001","status":"completed","api_amount":500000,
"result":{"keys":[{"key":"KEY-LMS-123456","expiry":"30/10/2026","plan":"1m"}]}}}

Key và ngày hết hạn trong ví dụ chỉ minh họa. Đọc ngày thật từ result; không tự tính ngày phía khách.

Kiểm tra số dư trước khi đặt

API dùng chung số dư ví với @LungMiuBOT theo Telegram ID. Nạp ví tại bot bằng các phương thức đang hỗ trợ; API chỉ tạo đơn bằng số dư ví, không tạo QR riêng. Hoàn tiền đơn lỗi do admin đối soát và xử lý.

curl "https://api.lungmiubot.shop/v1/balance"   -H "X-API-Key: lmb_your_private_key"

{ "balance": 500000, "currency": "VND" }

Tạo một lần, chống trùng tự động

client_order_id phải duy nhất trong tài khoản đại lý. Gửi lại cùng mã chỉ trả đơn cũ và không trừ tiền lần hai.

{
  "client_order_id": "MYBOT-20260930-001",
  "product_code": "proxy_http_SAMPLE",
  "quantity": 1,
  "input": {
    "username": "@khachhang",
    "note": "Thông tin cần thiết"
  }
}

curl "https://api.lungmiubot.shop/v1/orders/MYBOT-20260930-001"   -H "X-API-Key: lmb_your_private_key"

GET /v1/orders trả tối đa 100 đơn mới nhất của bạn. Để lấy nội dung giao, gọi GET /v1/orders/{client_order_id}. Hàng ZIP có result.files: tải download_url bằng header X-API-Key; link không công khai và chỉ chủ đơn tải được.

Giá Nâng VIP theo đại lý: admin có thể đặt số tiền cộng/trừ riêng cho gói 1/3/6/12 tháng, ví dụ +10.000đ hoặc -20.000đ mỗi gói. Mức này áp dụng trên giá API gốc, không dùng % chung. Nhập 0 hoặc để trống giữ giá VIP gốc. Giá không thấp hơn 0đ. Catalog trả price_adjust_type, price_adjust_amount, base_api_price và api_price; luôn dùng api_price làm giá thanh toán.

Nguyên liệu SS-Tool: hỗ trợ tele_ngoai_ss84spam (+84 SS Spam, 22.000đ), tele_ngoai_ss84add (+84 SS Add mem, 25.000đ), tele_ngoai_ss1spam (+1 SS Spam, 16.000đ) và tele_ngoai_ss1add (+1 SS Add mem, 20.000đ). Giá áp dụng thực tế lấy từ GET /v1/catalog, đã tính số tiền cộng/trừ riêng của đại lý. SS-Tool và TK Ngoại không áp dụng % chung; điều chỉnh tính trên mỗi sản phẩm, 0 giữ giá gốc. Không cần trường input. Kho dùng chung với bot; giao file theo thứ tự số thấp nhất còn hàng. Kết quả result.files chứa một ZIP gom đủ số lượng, tên theo mã DH; tải download_url bằng header X-API-Key. Mã DH trả trong result.order_code và source_order_code. Dùng lại cùng client_order_id để tránh tạo/trừ tiền hai lần.

Nhận kết quả ngay khi trạng thái đổi

Đăng ký một URL HTTPS công khai. Hệ thống ký raw body bằng HMAC-SHA256 để bot đại lý xác minh nguồn gửi.

{
  "url": "https://yourbot.example.com/lungmiu/webhook",
  "enabled": true
}

Mã lỗi dễ xử lý

Gọi API bằng Python

import requests

API = "https://api.lungmiubot.shop/v1"
headers = {"X-API-Key": "lmb_your_private_key"}

catalog = requests.get(f"{API}/catalog", headers=headers, timeout=20).json()
order = requests.post(f"{API}/orders", headers=headers, timeout=20, json={
    "client_order_id": "MYBOT-0001",
    "product_code": "tool_key_1m",
    "quantity": 1
}).json()

print(order)
# Nếu timeout, gửi lại cùng client_order_id, không tạo mã mới.
status = requests.get(f"{API}/orders/MYBOT-0001",
                      headers=headers, timeout=20).json()
print(status)