# H5接口

# 1.第三方企业获取用车目的列表

# 1.1 接入说明

美团企业版首页已为企业用户提供了企业用车等功能。如果企业希望在自己内部系统中直接完成企业用车的目的列表获取以及对应的用车跳转,则可以参考本接口文档完成相应的对接。大概使用流程如下:

  1. 员工通过企业自身系统进入相关页面。
  2. 员工点击企业用车相关按钮,返回对应的相关用车目的列表。
  3. 员工针对自身所需点击对应目的按钮,进行跳转。
  4. 美团打车使用。

注意: 因接口权限相关控制,三方企业无法直接调用打车对应接口,需通过美团企业版-免登接口通过验证后进行接口访问后重定向请求打车接口。

# 1.2 接口说明

名称 描述
功能 获取当前员工可用的用车目的列表
HTTP方法 POST
请求方 第三方企业
响应方 美团企业版平台
url $API_HOST/dache/queryCarUseTypeList
method dache.query.car.use.type.list

# 1.3 公共参数

详见:公共参数说明-公共请求参数

# 1.4 业务请求参数

名称 类型 是否非空 说明
entId Long 美团企业版为企业分配的企业唯一标识号
staffUniqCode Integer 第三方员工标识码。取值为:20: 邮箱账号 50: 手机号
value String 员工标识码对应的值

# 1.5 业务响应

名称 类型 说明
status Integer 0: 调用成功,其他值均为: 调用失败
msg String 失败时的错误描述
data List<Body> 请求成功时的响应数据,具体为出差申请单ID映射列表

Body 字段说明

名称 类型 是否非空 说明
useType String 使用场景。目前只用到这些标识 1:延时用车 4:差旅用车 7:日常公出
useTypeName String 使用场景对应的中文描述。可用来做对应页面展示
showName String 展示名称,接入方可使用这个名称作为用车目的展示项名称
iconUrl Integer 场景对应得展示图标
needJump String 点击是否需要跳转。默认都为true
jumpUrl String 跳转地址

# 1.6 示例

# 1.6.1 响应参数示例

{
  "status": 0,
  "message": "成功",
    "data": [
        {
            "useType": 1,
            "useTypeName": "延时用车",
            "showName": "延时用车",
            "iconUrl": "https://p1.meituan.net/travelcube/4df5c6cef1291290483efc11628c7d6d7630.png",
            "needJump": true,
            "jumpUrl": "https://c.qcs.test.sankuai.com/ent/dache/home/edit?isQCSTestCity=true&magicCityId=1000000001&mapEngineType=1&enableHotRegion=1&skipClearSqtToken=1&isEntDev=1&channelId=209&paramJson=JTdCJTIycnVsZUlkJTIyJTNBMTAwMDAyOTI2MSUyQyUyMnVzZVR5cGUlMjIlM0ExJTJDJTIydXNlVHlwZU5hbWUlMjIlM0ElMjIlRTUlQkIlQjYlRTYlOTclQjYlRTclOTQlQTglRTglQkQlQTYlMjIlMkMlMjJlbnRJZCUyMiUzQTEwMDc4NSUyQyUyMnN0YWZmSWQlMjIlM0E4MjgyMTElMkMlMjJydWxlUGFja0lkJTIyJTNBJTIyMTAwMDAwMTg0MSUyMiUyQyUyMnJ1bGVQYWNrTmFtZSUyMiUzQSUyMiVFNSVCQiVCNiVFNiU5NyVCNiVFNyU5NCVBOCVFOCVCRCVBNiUyMiU3RA%3D%3D&switchEntTab=0&ucHideList=MainCoupon%2C101%2C112%2C102%2C103%2C104"
        },
        {
            "useType": 7,
            "useTypeName": "日常公出",
            "showName": "包-车-公出1v",
            "iconUrl": "https://p1.meituan.net/travelcube/a25235f3c77fa550183bb56d47d3882b6596.png",
            "needJump": true,
            "jumpUrl": "https://c.qcs.test.sankuai.com/ent/dache/home/edit?isQCSTestCity=true&magicCityId=1000000001&mapEngineType=1&enableHotRegion=1&skipClearSqtToken=1&isEntDev=1&channelId=209&paramJson=JTdCJTIycnVsZUlkJTIyJTNBMTAwMDAyODMzNyUyQyUyMnVzZVR5cGUlMjIlM0E3JTJDJTIydXNlVHlwZU5hbWUlMjIlM0ElMjIlRTUlOEMlODUtJUU4JUJEJUE2LSVFNSU4NSVBQyVFNSU4NyVCQTF2JTIyJTJDJTIyZW50SWQlMjIlM0ExMDA3ODUlMkMlMjJzdGFmZklkJTIyJTNBODI4MjExJTJDJTIycnVsZVBhY2tJZCUyMiUzQSUyMjEwMDAwMDEwNjIlMjIlMkMlMjJydWxlUGFja05hbWUlMjIlM0ElMjIlRTUlOEMlODUtJUU4JUJEJUE2LSVFNSU4NSVBQyVFNSU4NyVCQTF2JTIyJTdE&switchEntTab=0&ucHideList=MainCoupon%2C101%2C112%2C102%2C103%2C104"
        },
        {
            "useType": 7,
            "useTypeName": "日常公出",
            "showName": "hx-公出1",
            "iconUrl": "https://p1.meituan.net/travelcube/a25235f3c77fa550183bb56d47d3882b6596.png",
            "needJump": true,
            "jumpUrl": "https://c.qcs.test.sankuai.com/ent/dache/home/edit?isQCSTestCity=true&magicCityId=1000000001&mapEngineType=1&enableHotRegion=1&skipClearSqtToken=1&isEntDev=1&channelId=209&paramJson=JTdCJTIycnVsZUlkJTIyJTNBMTAwMDAyODM5MSUyQyUyMnVzZVR5cGUlMjIlM0E3JTJDJTIydXNlVHlwZU5hbWUlMjIlM0ElMjJoeC0lRTUlODUlQUMlRTUlODclQkExJTIyJTJDJTIyZW50SWQlMjIlM0ExMDA3ODUlMkMlMjJzdGFmZklkJTIyJTNBODI4MjExJTJDJTIycnVsZVBhY2tJZCUyMiUzQSUyMjEwMDAwMDEyMjMlMjIlMkMlMjJydWxlUGFja05hbWUlMjIlM0ElMjJoeC0lRTUlODUlQUMlRTUlODclQkExJTIyJTdE&switchEntTab=0&ucHideList=MainCoupon%2C101%2C112%2C102%2C103%2C104"
        },
        {
            "useType": 4,
            "useTypeName": "差旅用车",
            "showName": "差旅用车",
            "iconUrl": "https://p0.meituan.net/travelcube/7fe335e477c05b866f807615bc60f6ac7733.png",
            "needJump": true,
            "jumpUrl": "https://test03-awp.hfe.test.sankuai.com/bepfe/slt-i-car/index.html#/trip-list"
        }
    ]
}
上次更新: 4/22/2024, 4:15:08 PM