Lấy danh sách các dịch vụ

API này dùng để lấy danh sách các dịch vụ đang được sử dụng theo từng tỉnh thành hoặc theo định vị

cURL

curl --location 'https://partner-apistg.ahamove.com/v3/services?city_id=SGN&delivery_type=INSTANT' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \

JavaScript

const myHeaders = new Headers();
myHeaders.append('Content-Type', 'application/json');
myHeaders.append('Authorization', 'Bearer <token>');

const requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow',
};

fetch(
  'https://partner-apistg.ahamove.com/v3/services?city_id=SGN&delivery_type=INSTANT',
  requestOptions
)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

HTTP Request

GET https://partner-apistg.ahamove.com/v3/services?city_id=SGN

Headers

Parameter	Giá trị	Yêu cầu	Mô tả
Content-Type	application/json	Có
Authorization	Bearer <token>	Có	Token của người dùng

Query Parameters

Parameter	Loại	Yêu cầu	Mô tả
lat	String	Có	Vĩ độ, Không bắt buộc nếu đã cung cấp city_id
lng	String	Có	Kinh độ, Không bắt buộc nếu đã cung cấp city_id
city_id	String	Có	Mã thành phố, Bắt buộc nếu không cung cấp vĩ độ và kinh độ
delivery_type	String	Không	Loại giao hàng. INSTANT đối với các dịch vụ public, TRUCK đối với các dịch vụ xe tải

Response

JSON response example:

[
    {
        "_id": "SGN-BIKE",
        "advance_broadcast_distance": 2000,
        "auto_assign": false,
        "auto_assign_distance": 1000,
        "city_id": "SGN",
        "cod": 10000000,
        "commission_type": "PERCENTAGE",
        "commission_value": 0.212,
        "currency": "VND",
        "delivery_type": "INSTANT",
        "description_en_us": "Giao hàng nội thành trong 1 giờ",
        "description_vi_vn": "Lấy hàng ngay, giao hỏa tốc",
        "distance_fee": "(25000 if x <= 2 else 19636 if x <= 3 else 19636 + (x - 3) * 5400)",
        ...

        # List of special requests
        "requests": [
            {
                "_id": "SGN-BIKE-TIP",
                "description_en_us": "This will show your support or compliment to the driver, especially in rush hours, hand to hand delivery, bad weather. Also, this feature will prioritize your request in peak time.",
                "description_vi_vn": "Hãy chọn dịch vụ này nếu bạn muốn hỗ trợ tài xế trong giờ cao điểm, khi cần giao hàng lên lầu, nơi phải tốn phí giữ xe, khi thời tiết khó khăn, hoặc đơn giản là muốn thưởng thêm cho tài xế. Ngoài ra, tính năng này sẽ giúp cho đơn hàng của bạn được ưu tiên hơn trong thời gian cao điểm.",
                "device_types": [],
                "enable": true,
                "group_id": "TIP",
                "max_input": 6,
                "name": "Hỗ trợ tài xế (PER_UNIT)",
                "price": 5000,
            }
        ],
    }
]

Status-Code: 200 OK

Các lỗi thường gặp

Mã lỗi	Nội dung	Mô tả
404	CITY_NOT_FOUND	- Không tìm thấy thành phố - Không thể xác định thành phố từ lat/lng
406	INVALID_DELIVERY_TYPE	Loại giao hàng không hợp lệ
500	INTERNAL_SERVER_ERROR	Hệ thống của chúng tôi có lỗi xảy ra. Xin thử lại sau
503	SERVICE_UNAVAILABLE	Chúng tôi tạm thời đang không hoạt động để bảo trì. Xin vui lòng thử lại sau