SIEUTHIMMOVN DEVELOPER

API tài khoản & Gmail

Mua sản phẩm giao tự động, xem kết quả và kiểm tra số dư ví website.

KEYAPI_USE

Khóa API của bạn

Đổi key sẽ vô hiệu key cũ. Đơn API mới dùng chung số dư ví website và xuất hiện trong Lịch sử.

API REFERENCE

Hướng dẫn kết nối

Base URL: https://sieuthimmovn.com/otpapi/api.php

Method	Action	Chức năng
GET	?action=products	Kho sản phẩm API, giá VND và tồn kho
GET	?action=balance	Số dư ví website
POST	?action=buy-product	Mua bằng product_id, quantity và Idempotency-Key
GET	?action=product-order&id=123	Xem đơn của chính tài khoản bạn và Gmail đã giao

Xác thực

Gửi X-API-Key: YOUR_KEY hoặc Authorization: Bearer YOUR_KEY. Chỉ dùng từ máy chủ hoặc tool riêng.

Chống mua trùng

Mỗi lần mua dùng Idempotency-Key riêng dài 16–80 ký tự. Khi thử lại cùng giao dịch, giữ nguyên key. Key của đơn đã dọn sẽ bị từ chối.

Lịch sử thống nhất

Đơn API dùng số dư website, hiển thị cùng đơn Gmail đã mua trên web. Số dư API cũ vẫn được giữ trong database, không tự chuyển ví.

cURL

curl -H "X-API-Key: YOUR_KEY" "https://sieuthimmovn.com/otpapi/api.php?action=products"

curl -X POST "https://sieuthimmovn.com/otpapi/api.php?action=buy-product" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Idempotency-Key: unique_purchase_20261008_001" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"PRODUCT_ID_FROM_CATALOG","quantity":1}'

curl -H "X-API-Key: YOUR_KEY" "https://sieuthimmovn.com/otpapi/api.php?action=product-order&id=123"

Python

import requests, uuid
base = "https://sieuthimmovn.com/otpapi/api.php"
headers = {"X-API-Key": "YOUR_KEY"}
products = requests.get(base, params={"action": "products"}, headers=headers, timeout=30).json()
print(products)
# Chọn product_id từ danh sách trước khi gửi mua.
headers["Idempotency-Key"] = str(uuid.uuid4())
response = requests.post(base, params={"action": "buy-product"}, headers=headers,
                         json={"product_id": "PRODUCT_ID_FROM_CATALOG", "quantity": 1}, timeout=60)
print(response.status_code, response.json())