Khởi đầu nhanh với API khách hàng: Tích hợp Accplanet /api/v2 trong một vòng lặp

Nếu bạn mua hàng trên Accplanet theo cách lập trình, bạn không cần một API riêng cho từng thao tác. Customer API sử dụng một endpoint duy nhất — POST https://accplanet.com/api/v2 — và một tham số action. Hướng dẫn này là phần khởi đầu nhanh thực tế để lập trình viên có thể liệt kê các mục 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 ngồi.

Accplanet là một thị trường tổng hợp nhà cung cấp. Các nhà cung cấp đảm nhận việc tồn kho; Accplanet cung cấp khám phá, thanh toán, theo dõi đơn hàng và hỗ trợ. Chỉ sử dụng API cho mục đích quản lý đơn hàng hợp pháp. Tài liệu tham khảo đầy đủ: Tài liệu Customer API.

Xác thực và endpoint

Tạo hoặc sao chép khóa API khách hàng của bạn từ trang khóa API trong hồ sơ Accplanet, sau đó gọi:

POST https://accplanet.com/api/v2

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

Các action được hỗ trợ: categories, shops, services, inventory, add, status, balance.

Các bước tích hợp

Dừng lại khi mỗi bước trả về phản hồi sạch trước khi chuyển sang bước tiếp theo.

Công thức curl sao chép-dán

# Balance
curl -X POST https://accplanet.com/api/v2 -d "key=YOUR_API_KEY" -d "action=balance"

# Services page
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=services" -d "page=1" -d "limit=50"

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

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

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

Thay thế các placeholder bằng khóa của bạn, một service thực từ services và order do add trả về. Bắt đầu với số lượng 1 trên một mặt hàng thử nghiệm chi phí thấp.

Lỗi và giới hạn tốc độ

• Thông tin xác thực không hợp lệ → HTTP 401 với {"error":"Invalid API key"}.
• Các vấn đề xác thực / tồn kho / số dư → thường là HTTP 400 với một chuỗi error duy nhất (ví dụ: tồn kho hoặc số dư không đủ).