获取开放城市

简介

获取开放城市以及相应开放车级。

服务提供方

享道

接口URL

/openapi/opencity/query

请求方式

POST

请求频次

单次

请求参数

参数名称	类型	必选	说明
timestamp	long	是	请求时间，Unix Timestamp单位毫秒

响应参数

参数名称	类型	必有	说明
errCode	int	是	服务响应状态，参见附录5
errMsg	string	是	服务响应状态说明，参见附录5
content	object	是
content. cityInfos	list	否	开放城市
content. cityInfos. cityCode	string	是	城市编码 附录6
content. cityInfos. cityName	string	是	城市名称
content. cityInfos. productTypes	list	是	业务线，支持车辆类型
content. cityInfos. productTypes. productType	string	是	产品类型 附录 1
content. cityInfos. productTypes. productName	string	是	产品说明 附录 1
content. cityInfos. productTypes. carLevels	list	是	运力说明 附录 1
content. cityInfos. productTypes. carLevels. carLevel	string	是	运力说明 附录 1
content. cityInfos. productTypes. carLevels. carLevelName	string	是	运力说明 附录 1

请求示例

请求

curl --location --request POST 'https://open-sit.saicmobility.com/merchant/v1/openapi/opencity/query' \
--header 'X-Sign: aba9889b5d576a22aa1709a582bc95ccf9f902cf' \
--header 'X-SignAlgorithm: 1' \
--header 'X-Timestamp: 20201020161100' \
--header 'X-MerchantId: open_app_uOzMWv59sDGCUC5t' \
--header 'Content-Type: application/json' \
--header 'Cookie: tgw_l7_route=9b69b70c209c605c67685e2fbfdbf308' \
--data-raw '{}'

响应

{
    "errCode": 10000,
    "errMsg": "successful",
    "content": {
        "cityInfos": [
            {
                "cityCode": "0379",
                "cityName": "洛阳市",
                "productTypes": [
                    {
                        "productType": "private-car",
                        "productName": "专车",
                        "carLevels": [
                            {
                                "carLevel": "compact",
                                "carLevelName": "舒享型"
                            }
                        ]
                    }
                ]
            },
            // …… …… ……（略）
            {
                "cityCode": "0510",
                "cityName": "无锡市",
                "productTypes": [
                    {
                        "productType": "private-car",
                        "productName": "专车",
                        "carLevels": [
                            {
                                "carLevel": "compact",
                                "carLevelName": "舒享型"
                            },
                            {
                                "carLevel": "premium",
                                "carLevelName": "尊享型"
                            },
                            {
                                "carLevel": "business",
                                "carLevelName": "商务六座"
                            }
                        ]
                    }
                ]
            }
        ]
    }
}

无数据响应

{
    "errCode": 10000,
    "errMsg": "successful",
    "content": {}
}