SIEUTHIMMOVN DEVELOPER

Account & Gmail API

Buy automatically delivered products, retrieve results and check website wallet balance.

KEYAPI_USE

Your API key

Rotating your key disables the old key. New API purchases use the website wallet and appear in History.

API REFERENCE

Integration guide

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

Method	Action	Purpose
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())