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.
https://shopacp.cloud/api/v1REST 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 đã đồ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.
Tổng quan về định dạng JSON, nguyên tắc tích hợp và môi trường API.
https://shopacp.cloud/api/v1AUTH X-Access-TokenGửi API token trong header X-Access-Token cho các request cần bảo mật.
X-Access-Token: YOUR_API_TOKENGET /product/categoriesLấy danh sách danh mục sản phẩm đang được công khai.
curl -X GET 'https://shopacp.cloud/api/v1/product/categories' -H 'X-Access-Token: YOUR_API_TOKEN'GET /product/{slug}Lấy thông tin sản phẩm theo slug và các gói đang bán.
curl -X GET 'https://shopacp.cloud/api/v1/product/{slug}' -H 'X-Access-Token: YOUR_API_TOKEN'POST /product/orderTạo đơn mua sản phẩm bằng API token của tài khoản.
curl -X POST 'https://shopacp.cloud/api/v1/product/order' -H 'X-Access-Token: YOUR_API_TOKEN'POST /product/order-bankTạo đơn và theo dõi giao dịch thanh toán ngân hàng.
curl -X POST 'https://shopacp.cloud/api/v1/product/order-bank' -H 'X-Access-Token: YOUR_API_TOKEN'GET /product/order-bank/{id}/statusTra cứu trạng thái đơn thanh toán ngân hàng theo mã giao dịch.
curl -X GET 'https://shopacp.cloud/api/v1/product/order-bank/{id}/status' -H 'X-Access-Token: YOUR_API_TOKEN'GET /lt/servicesCác endpoint tài liệu, dịch vụ, máy chủ và đơn hàng dành cho đại lý.
curl -X GET 'https://shopacp.cloud/api/v1/lt/services' -H 'X-Access-Token: YOUR_API_TOKEN'INFO Errors & limitsKiểm tra mã lỗi, xác thực token và nguyên tắc retry an toàn khi tích hợp.
curl -X INFO 'https://shopacp.cloud/api/v1Errors & limits' -H 'X-Access-Token: YOUR_API_TOKEN'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.