Vận chuyển
Danh sách hãng vận chuyển
Lấy danh sách hãng vận chuyển (carrier) shop đã kết nối
Endpoint
GET /v1/shippingcarriers
Không yêu cầu quyền riêng. Trường api_setting chỉ có dữ liệu khi người gọi có quyền setting.sale (trường bí mật luôn được che).
Query Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
page | int | Không | Số trang (Mặc định: 1) |
limit | int | Không | Số bản ghi mỗi trang (Mặc định và tối đa: 50) |
id | int | Không | Lọc theo ID carrier |
status | int | Không | Lọc theo trạng thái: 1 (Bật), 3 (Tắt) |
keyword | string | Không | Từ khoá tìm kiếm |
sort_by | string | Không | Trường sắp xếp |
sort_type | string | Không | ASC hoặc DESC. Mặc định: ASC |
Response Schema
HTTP 200 - JSON Object
| Trường | Kiểu | Mô tả |
|---|---|---|
total | int | Tổng số bản ghi |
currentpage | int | Trang hiện tại |
limit | int | Số bản ghi mỗi trang |
items | array | Mảng Shipping Carrier Object |
Danh sách rút gọn (đang bật)
GET /v1/shippingcarriers/fulldata
Trả về mảng toàn bộ carrier đang bật của công ty (không phân trang), mỗi phần tử gồm:
| Trường | Kiểu | Mô tả |
|---|---|---|
id | int | ID carrier |
name | string | Tên hiển thị |
api_type | int | Loại hãng |
display_order | int | Thứ tự hiển thị |
Danh sách loại hãng
GET /v1/shippingcarriers/apitypes
Danh sách các loại hãng Hubport hỗ trợ, dùng cho form tạo carrier.
{
"items": [
{ "api_type": 7, "name": "ghtk", "creatable": true },
{ "api_type": 9, "name": "jtexpress", "creatable": true },
{ "api_type": 11, "name": "superai", "creatable": false },
{ "api_type": 13, "name": "be", "creatable": true },
{ "api_type": 15, "name": "viettelpost", "creatable": true },
{ "api_type": 17, "name": "ahamove", "creatable": true },
{ "api_type": 19, "name": "ghn", "creatable": true }
]
}creatable = false: hãng đang ẩn, không tạo mới / không đổi carrier khác sang loại này được (carrier đã có vẫn hoạt động và sửa được).
Ví dụ cURL
curl -X GET "https://api.hubport.vn/v1/shippingcarriers?status=1" \
-H "Authorization: <JWT>"