Nền tảng mở HIOBuy

HIOBuy là đối tác công nghệ được ủy quyền chính thức của Taobao, 1688 và Weidian. Chúng tôi kết nối các nguồn hàng Trung Quốc với nền tảng của bạn thông qua một API hợp nhất — không chỉ dữ liệu sản phẩm, mà toàn bộ luồng từ đồng bộ catalog đến mua hàng tự động và (tùy chọn) giao hàng quốc tế.

HIOBuy cung cấp những gì

Khác với các công cụ scrape marketplace thông thường hoặc nguồn dữ liệu chỉ đọc, HIOBuy được xây dựng quanh fulfillment đầu cuối. Tích hợp của bạn nên tạo ra giao dịch thật trên storefront của bạn và thông qua các API mua hộ của chúng tôi.

Sơ đồ (HIOBuy kết nối nguồn hàng Trung Quốc với nền tảng của bạn: đồng bộ sản phẩm, nhận đơn hàng, mua tự động và đồng bộ trạng thái)

HIOBuy nằm giữa các marketplace Trung Quốc và doanh nghiệp của bạn — đồng bộ sản phẩm, nhận đơn hàng, tự động mua hàng và đẩy trạng thái trở lại dashboard của bạn.

Khả năngÝ nghĩa với bạn
Đồng bộ sản phẩmTìm kiếm, chi tiết, tìm bằng ảnh, SKU/tồn kho/giá từ 1688, Taobao, Weidian qua /v1/products/*
Nhận đơn hàngBackend của bạn gửi đơn hàng khách hàng đến HIOBuy khi có giao dịch trên website của bạn
Mua tự độngHIOBuy đặt đơn tương ứng trên marketplace nguồn qua /v1/orders/*
Đồng bộ trạng tháiTiến trình mua hàng, logistics nội địa và (ở chế độ kho) tracking quốc tế chảy ngược về hệ thống của bạn — xem Webhooks
Fulfillment quốc tếTùy chọn: kiện hàng nhập kho được gửi ra nước ngoài qua /v1/fulfillment/* (chỉ chế độ kho)

Chúng tôi khác gì so với các API khác

  • Truy cập kênh chính thức — tích hợp đối tác được ủy quyền, không phải scrape không chính thức.
  • Định hướng giao dịch — API sản phẩm tồn tại để hỗ trợ sourcing và checkout; API mua hộ hoàn tất vòng mua hàng.
  • Phản hồi chuẩn hợp nhất — một schema cho 1688, Taobao và Weidian; xem Định dạng phản hồi.
  • Fulfillment trọn gói tùy chọn — chế độ tự vận hành cho người mua tự quản lý logistics; chế độ kho khi HIOBuy lưu kho và gửi hàng quốc tế.

Mục đích sử dụng được chấp nhận & hạn mức {#acceptable-use}

Quyền truy cập API không phải không giới hạn. Quota và rate limit gắn với thỏa thuận thương mại của bạn và khối lượng giao dịch (GMV) dự kiến qua nền tảng.

HIOBuy dành cho các tích hợp trong đó việc khám phá sản phẩm dẫn đến đơn hàng thật — khách hàng mua trên website của bạn, và backend của bạn gọi /v1/orders/* để mua hộ. Các ứng dụng chỉ tiêu thụ tìm kiếm/chi tiết sản phẩm mà không có hoạt động mua hàng đáng kể, hoặc bỏ qua HIOBuy cho phần mua hộ trong khi vẫn dùng API catalog của chúng tôi, không được hỗ trợ và có thể bị tạm ngưng sau khi xem xét.

Header rate-limit kỹ thuật và mã lỗi được ghi trong Rate limits. Điều khoản thương mại được thống nhất khi onboarding — không lặp lại trong từng trang endpoint.

Luồng tích hợp {#integration-flows}

Chọn chế độ fulfillment trong developer portal khi bạn ủy quyền app. Đường đi API sản phẩm tương tự nhau; mua hộ và vận chuyển quốc tế sẽ khác.

Self fulfillment — bạn vận hành mua hộ

Phù hợp nhất khi bạn đã có tài khoản marketplace và tự xử lý kho bãi.

  1. Đồng bộ sản phẩm — 1688 / Taobao / Weidian → HIOBuy Gateway: tìm kiếm, chi tiết, ảnh, SKU, tồn kho
  2. Hiển thị — HIOBuy Gateway → storefront của bạn
  3. Đơn hàng khách hàng — khách hàng của bạn → website của bạn
  4. Mua hộ — backend của bạn → HIOBuy Gateway: POST /v1/orders/preview → tạo → thanh toán
  5. Mua tự động — HIOBuy Gateway → Marketplace (OAuth của bạn)
  6. Trả trạng thái — Marketplace → HIOBuy Gateway: mua hàng & logistics nội địa
  7. Đồng bộ dashboard — HIOBuy Gateway → dashboard của bạn

Vận chuyển quốc tế (/v1/fulfillment/*) không khả dụng trong self mode. Bạn tự xử lý giao hàng ra nước ngoài.

HIOBuy warehouse fulfillment — đầu cuối

Một mã kho liên kết tất cả kênh; HIOBuy mua hộ, lưu kho và gửi hàng quốc tế.

  1. API sản phẩm — vẫn gọi trực tiếp marketplace (độ trễ thấp)
  2. Đồng bộ sản phẩm — đến website hướng khách hàng của bạn
  3. Đơn hàng khách hàng — trên website của bạn
  4. Mua hộ — POST /v1/orders/* (chuyển tiếp đến kho HIOBuy)
  5. Mua tự động — kho HIOBuy → Marketplace bằng token được quản lý
  6. Nhập kho — hàng đến nơi; parcel_nos trong chi tiết đơn hàng
  7. Quốc tế — freight/estimate → preview → create → pay
  8. Giao hàng — truy vết qua /v1/fulfillment/shipments/logistics/trace

API mua hộ và quốc tế đi qua HIOBuy. API sản phẩm vẫn đi trực tiếp đến nền tảng để đảm bảo tốc độ.

So sánh chế độ

Self fulfillmentKho HIOBuy
Token kênhBạn quản lý OAuth theo từng kênhMột mã kho liên kết tất cả kênh
/v1/products/*Gateway → marketplaceGateway → marketplace (trực tiếp, độ trễ thấp)
/v1/orders/*Gateway → marketplace (token của bạn)Gateway → API kho HIOBuy
/v1/fulfillment/*Không khả dụngVận chuyển quốc tế + số dư

Cách trở thành developer {#become-a-developer}

  1. Đăng ký bằng thông tin công ty, website và use case (ví dụ: purchasing agent, cửa hàng xuyên biên giới).
  2. Xác minh địa chỉ email.
  3. Đăng nhập và tạo một App trong developer portal — mô tả tích hợp và lưu lượng dự kiến.
  4. Chờ HIOBuy review. Chúng tôi duyệt các app phù hợp với sourcing dựa trên giao dịch; bạn sẽ nhận quota và quyền truy cập kênh tương ứng.
  5. Sau khi được duyệt: ủy quyền kênh (self OAuth hoặc mã kho), rồi tạo API key trong API Keys.
  6. Tích hợp: chi tiết sản phẩm → checkout khách hàng → preview/create mua hộ → thanh toán → webhook trạng thái. Ở chế độ kho, thêm luồng shipment quốc tế.

Cần mã developer kho? Liên hệ vận hành HIOBuy sau khi app của bạn được duyệt cho warehouse fulfillment.

Bản đồ tham chiếu API

Base URL: https://api.hiobuy.com/v1

Khu vựcPrefixTài liệu
Sản phẩm/v1/products/*Products
Mua hộ/v1/orders/*Procurement orders
Fulfillment/v1/fulfillment/*Shipments & balance

Hai loại đơn hàng — không trộn lẫn: mua hộ (/v1/orders/*) mua từ người bán Trung Quốc vào kho nội địa; shipment quốc tế (/v1/fulfillment/shipments/*) gửi các kiện đã nhập kho ra nước ngoài.

Thứ tự đọc khuyến nghị {#reading-order}

  1. Trở thành developer — đăng ký, duyệt app, API key
  2. Authentication + Portal authorization
  3. Products → Procurement orders
  4. Tùy chọn: Fulfillment (chế độ kho)
  5. Errors & Rate limits khi harden production

Phạm vi Public API {#public-api-scope}

Tài liệu này mô tả bề mặt Public API được hỗ trợ. Một số path có thể xuất hiện trong openapi.json  cho mục đích nội bộ hoặc đã deprecated (ví dụ legacy /v1/shipments, refund routes) — nếu endpoint không được liệt kê tại đây, hãy xem như không khả dụng.

Quy ước kỹ thuật {#technical-conventions}

  • Auth: Authorization: Bearer YOUR_API_KEY — Authentication
  • Product language trong JSON body — Languages
  • Giá: CNY yuan trên sản phẩm, fen trên đơn hàng và shipment
  • response_format: "standard" (mặc định) hoặc "upstream" — Response format

OpenAPI spec: api.hiobuy.com/openapi.json 

Tài liệu đã xuất bản: hiobuy.com/api-docs