Nhảy tới nội dung
Phiên bản: 3.0.0

Giới thiệu

Chức năng của Ahamove API​

  • Tạo token: Đối tác đăng kí một tài khoản dành cho người dùng và Ahamove sử dụng API_KEY để tạo ra token dùng để truy cập API
  • Lấy dữ liệu để truy xuất được danh sách các thành phố và dịch vụ Ahamove đang hoạt động
  • Ước tính khoảng cách và chi phí giao hàng: Đối tác có thể dễ dàng sử dụng API để kiểm tra giá và khoảng cách trước khi tạo một đơn hàng
  • Tạo đơn hàng: Dùng token đã có được để tạo đơn hàng mới thông qua API Tạo đơn
  • Hủy đơn hàng: Nếu muốn hủy một đơn hàng (trước khi đến trạng thái IN PROCESS), sử dụng API Hủy đơn
  • Callback trạng thái đơn hàng: Người dùng cần phải cung cấp một Webhook URL và phương pháp định danh (nếu có) để nhận các cập nhật trạng thái từ Ahamove

API Key & Business Portal​

API Keys được dùng để xác nhận việc tích hợp của Đối tác và kiểm soát quyền truy cập vào API của Ahamove

Business Portal hỗ trợ Đối tác quản lý:

  • Đơn hàng: lên đơn, theo dõi và xem chi tiết đơn
  • Nhân viên, cửa hàng và phân quyền
  • API key, webhook và kiểm thử tích hợp trước khi go-live
  • Thanh toán, đối soát và hoá đơn VAT

Làm sao để có API_KEY?

Bạn có thể đăng ký developer key mới tại Biểu mẫu Tích hợp

Sau khi xác nhận hoàn thành biểu mẫu, Ahamove sẽ gửi cho Đối tác một API Key và một tài khoản Business Portal thông qua email

Môi trường​

Ahamove cung cấp 2 môi trường để tích hợp với API_KEY dựa trên URL cho tất cả các yêu cầu chi tiết trong tài liệu này:

Môi trường Sandbox/Staging​

  • Host
https://partner-apistg.ahamove.com/v3
  • Business Portal

business-stg.ahamove.com

Môi trường Production​

  • Host
https://partner-api.ahamove.com/v3
  • Business Portal

business.ahamove.com

Đối với phương thức POST trong cả 2 môi trường, Đối tác cần sử dụng URL-encoded