Hỗ trợ 24/7 trực tuyến Giờ làm việc: 08:00 - 22:00
Trang chủ/Tài liệu API Kho Key Game

Tài liệu API Kho Key Game

REST API giúp đại lý tích hợp kho key game, sản phẩm bản quyền, đơn hàng và số dư trực tiếp vào hệ thống của mình.

Tài liệu API Kho Key Game

Chờ bật API

Tài liệu đã đồng bộ theo route API dùng chung của hệ thống chính. Backend API cần được public ở miền gốc trước khi đại lý gọi chính thức.

RESTful JSONX-Access-TokenĐồng bộ tức thìKiểm soát an toàn
THAM CHIẾU API
ENDPOINT 01

Giới thiệu

Tổng quan về định dạng JSON, nguyên tắc tích hợp và môi trường API.

Base URL
https://shopacp.cloud/api/v1
Đây là API dùng chung với hệ thống chính của website.
ENDPOINT 02

Xác thực

AUTH X-Access-Token

Gửi API token trong header X-Access-Token cho các request cần bảo mật.

Header
X-Access-Token: YOUR_API_TOKEN
ENDPOINT 03

Danh mục sản phẩm

GET /product/categories

Lấy danh sách danh mục sản phẩm đang được công khai.

Request mẫu
curl -X GET 'https://shopacp.cloud/api/v1/product/categories' -H 'X-Access-Token: YOUR_API_TOKEN'
ENDPOINT 04

Thông tin sản phẩm

GET /product/{slug}

Lấy thông tin sản phẩm theo slug và các gói đang bán.

Request mẫu
curl -X GET 'https://shopacp.cloud/api/v1/product/{slug}' -H 'X-Access-Token: YOUR_API_TOKEN'
ENDPOINT 05

Mua sản phẩm

POST /product/order

Tạo đơn mua sản phẩm bằng API token của tài khoản.

Request mẫu
curl -X POST 'https://shopacp.cloud/api/v1/product/order' -H 'X-Access-Token: YOUR_API_TOKEN'
ENDPOINT 06

Mua bằng ngân hàng

POST /product/order-bank

Tạo đơn và theo dõi giao dịch thanh toán ngân hàng.

Request mẫu
curl -X POST 'https://shopacp.cloud/api/v1/product/order-bank' -H 'X-Access-Token: YOUR_API_TOKEN'
ENDPOINT 07

Trạng thái thanh toán

GET /product/order-bank/{id}/status

Tra cứu trạng thái đơn thanh toán ngân hàng theo mã giao dịch.

Request mẫu
curl -X GET 'https://shopacp.cloud/api/v1/product/order-bank/{id}/status' -H 'X-Access-Token: YOUR_API_TOKEN'
ENDPOINT 08

Tài liệu nâng cao

GET /lt/services

Các endpoint tài liệu, dịch vụ, máy chủ và đơn hàng dành cho đại lý.

Request mẫu
curl -X GET 'https://shopacp.cloud/api/v1/lt/services' -H 'X-Access-Token: YOUR_API_TOKEN'
ENDPOINT 09

Lỗi & giới hạn

INFO Errors & limits

Kiểm tra mã lỗi, xác thực token và nguyên tắc retry an toàn khi tích hợp.

Request mẫu
curl -X INFO 'https://shopacp.cloud/api/v1Errors & limits' -H 'X-Access-Token: YOUR_API_TOKEN'
Cần triển khai backend API ở miền gốc

URL tài liệu dự kiến là https://shopacp.cloud/api/v1. Hiện host trả 404 cho endpoint này, nên chưa nên cấp token hoặc dùng API production. Sau khi deploy route API, chỉ cần giữ nguyên URL hoặc cập nhật api_base_url trong phần cài đặt.