Tài liệu API

Tự động hóa quy trình làm việc của bạn với API hiệu suất cao.

Hiệu suất cao

Tối ưu hóa tốc độ với thời gian phản hồi dưới 100ms.

Bảo mật

Bảo mật với xác thực API Key và giới hạn tần suất.

Tin cậy

Cam kết uptime 99.9% cho các tác vụ tự động hóa quan trọng.

01
Xác thực

Xác thực yêu cầu của bạn bằng cách gửi API key trong header x-api-key header.

curl https://mmostore.site/api/v1/market/buy \
  -H "x-api-key: YOUR_API_KEY"

Note: Lưu ý: Giữ bí mật API key của bạn. Không chia sẻ trong mã phía client.

02
Mua sản phẩm

POST/api/v1/market/buy

Content-Type: application/json

Thực hiện đơn hàng mới cho một sản phẩm cụ thể.

Body Parameters

Field	Type	Required	Description
productId	string	Yes	UUID of the product to purchase
quantity	number	Yes	Number of items (min: 1)
variantId	string	Optional	UUID of product variant (required if product has variants)

Example Request

curl -X POST https://mmostore.site/api/v1/market/buy \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "productId": "123e4567-e89b-12d3-a456-426614174000",
    "quantity": 1
  }'

Success Response (200 OK)

{
  "success": true,
  "orderId": "ord_123...",
  "items": [
    "email@example.com|password123",
    ...
  ],
  "totalAmount": 50000,
  "remainingBalance": 150000
}

03
Mã lỗi

Các mã lỗi HTTP tiêu chuẩn được API trả về.

Mã	Mô tả
400	Yêu cầu không hợp lệ (Thiếu tham số, sai định dạng).
401	Chưa xác thực (API Key không hợp lệ hoặc bị thiếu).
402	Thanh toán thất bại (Số dư không đủ).
403	Không có quyền truy cập (API bị tắt hoặc key bị khóa).
404	Không tìm thấy (Sản phẩm không tồn tại).
429	Quá nhiều yêu cầu (Vượt quá giới hạn 150 req/phút).
500	Lỗi máy chủ nội bộ.