Bắt đầu nhanh với Accplanet Customer API: Liệt kê, Kiểm tra Kho hàng và Đặt hàng

By Olivia Chen

Tháng 9 13, 2026 Buyer Tips 👁 158 lượt xem

Accplanet Customer API API key api design principles POST /api/v2 reseller API integration check stock API place order API Accplanet services API

Accplanet Customer API quick start

Get an API key and call POST /api/v2 to list services, check inventory, place an order, and poll status.

Create an API key
Open Profile → API key on Accplanet, generate a key, and store it in a secret environment variable.
List services and check stock
POST https://accplanet.com/api/v2 with action=services (cache results), then action=inventory for target service IDs.
Place order and poll status
POST action=add with service and quantity, then poll action=status with the returned order id. Honor HTTP 429 Retry-After.

Nếu bạn mua trên Accplanet theo cách lập trình, bạn không cần một URL khác cho mỗi hành động. Accplanet Customer API sử dụng một endpoint duy nhất — POST https://accplanet.com/api/v2 — cùng một tham số action. Hướng dẫn này là bản khởi đầu nhanh thực tế để một nhà bán lại hoặc hệ thống tự động có thể liệt kê các mặt hàng trong danh mục, kiểm tra tồn kho, đặt hàng và theo dõi trạng thái trong một lần làm việc.

Accplanet là một marketplace nhà cung cấp. Customer API dành cho người mua và nhà bán lại đã có số dư. Bảng tham số đầy đủ nằm trong tài liệu Customer API; bài viết này tập trung vào con đường hoạt động ngắn nhất.

Tóm tắt nhanh

Tạo một API key trong hồ sơ Accplanet của bạn và lưu trữ nó như mật khẩu.
Gọi POST https://accplanet.com/api/v2 với key + action (trường form hoặc JSON).
Vòng lặp điển hình của nhà bán lại: services → inventory → add → status (tùy chọn balance).
Cache các lần đọc danh mục. Coi HTTP 429 + Retry-After là yêu cầu bắt buộc phải chờ, không phải gợi ý tùy chọn.
Dùng bài viết này để tích hợp nhanh; dùng tài liệu chính thức cho mọi trường.

Lấy API key của bạn

Đăng nhập, mở Hồ sơ → API key, và tạo một API key. Sao chép nó một lần vào trình quản lý bí mật hoặc biến môi trường (ví dụ ACCPLANET_API_KEY). Mọi lệnh gọi Customer API đều xác thực bằng key đó trong body với tên key (bí danh apikey).

{
  "key": "YOUR_API_KEY",
  "action": "categories"
}

Bạn cũng có thể gửi các trường mã hóa form bằng curl -d. Ưu tiên biến môi trường hơn chuỗi được mã hóa cứng.

Nguyên tắc thiết kế API (vì sao chỉ một endpoint)

Customer API của Accplanet tuân theo một vài nguyên tắc thiết kế API thực tế giúp việc tích hợp cho nhà bán lại trở nên đơn giản hơn:

Một điểm vào duy nhất: một URL, nhiều giá trị action — ít URL cơ sở cần cấu hình hơn.
Xác thực rõ ràng: API key đi kèm mỗi yêu cầu; không cần cookie phiên không rõ ràng cho các script.
Từ vựng hành động: services, inventory, add, status, balance và các hành động liên quan ánh xạ gọn gàng theo danh mục → tồn kho → đặt hàng → theo dõi.
Cấu trúc lỗi ổn định: các lệnh gọi thất bại trả về lỗi có cấu trúc; giới hạn tốc độ dùng HTTP 429.

Thiết kế đó là lý do vì sao một client tối giản thường chỉ là một lớp bọc mỏng: đặt key, chọn action, phân tích JSON.

Lộ trình tích hợp

1 · Kiểm tra nhanh

Liệt kê danh mục

Xác nhận key hoạt động trước khi bạn nối logic đặt hàng.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories"

2 · Danh mục

Lấy services (sản phẩm)

Dùng action=services cho Accplanet services API / đồng bộ danh mục. Ưu tiên limit lớn hơn (tối đa 500) và cache phản hồi cục bộ ít nhất 60–120 giây. Đây là hành động mà nhà bán lại chạm giới hạn tốc độ đầu tiên.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "limit=100"

3 · Tồn kho

Kiểm tra inventory trước khi add

Để dùng đường dẫn check stock API, gọi action=inventory với các ID service bạn quan tâm. Bỏ qua các lệnh add mù quáng khi tồn kho đã bằng không trong cache của bạn.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "services=10042"

4 · Đặt hàng

Đặt hàng, rồi theo dõi trạng thái

Place order API: action=add với service và tùy chọn quantity / link. Sau đó theo dõi bằng action=status và id đơn hàng được trả về. Không theo dõi trạng thái mỗi giây.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=10042" \
  -d "quantity=1"

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=ORDER_ID"

Giới hạn tốc độ phá vỡ các tích hợp đầu tiên

Lưu lượng Customer API đã xác thực b