# 企业出差申请单接口
美团企业版为企业客户提供了两种出差申请对接方案,具体如下图所示。
(1)若企业客户希望在内部系统完成出差申请,并将出差申请单同步到美团企业版,请参照如图1所示的接口1.企业出差申请单同步进行对接。
(2)若企业客户希望在美团企业版完成出差申请,同时对出差申请单查询有需求,请参照如图2所示的接口2.企业出差申请单查询进行对接。
(3)若企业客户希望美团企业版能够在出差申请单状态变更时,主动向企业推送出差申请单信息请参照如图3所示3.企业出差申请单推送进行对接。
# 1 企业出差申请单同步
# 1.1 接入说明
美团企业版为客户提供了出差申请、审批功能,如果企业客户希望在内部系统完成出差申请,在出差申请通过后在美团企业版进行机票、酒店、火车票预订,则可以通过本文档进行接口对接。流程如下
- 企业内部完成出差申请,在审批通过后,通过调用接口将差旅申请信息同步给美团企业版
- 企业员工通过免登跳转到美团企业版差旅h5页面,选中对应的出差申请单进行机票、酒店、火车票预订
- 预订机酒火时,会根据出行人的差标信息进行差标控制
注意:按行程维度严控且需动态差标管控的企业,暂不支持申请单内容的修改,只可新增/撤回单据
# 1.2 接口说明
名称 | 描述 |
---|---|
功能 | 创建差旅申请单 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /trip/applySync |
method | trip.apply.sync |
# 1.3 公共参数
# 1.4 业务请求参数
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
tripList | List<Trip> | 是 | 同步的出差申请列表 |
Trip 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
outTripId | String | 是 | 外部企业的申请单号 |
reason | String | 否 | 行程原因,超出500个字符的部分会被截断 |
approveStatus | Integer | 是 | 出差申请状态 (1 通过 -1 撤回 2 驳回 3 审批中) |
costCenterInfos | List<CostCenterInfo> | 否 | 成本中心列表 |
projectInfos | List<ProjectInfo> | 否 | 项目列表,现状仅支持传一个项目或不传项目。当projectInfos传值时,其中的ProjectInfo中字段都不允许为空 |
invoiceTitle | String | 是 | 企业发票抬头 |
tripStaffInfos | List<StaffInfo> | 否 | 出行人的用户列表 |
tripGuestInfos | List<TripGuestInfo> | 否 | 外部出行人列表 |
applyStaffInfo | StaffInfo | 是 | 出差申请的提交用户 |
tripItineraries | List<TripPushItinerary> | 否 | 行程列表 |
tripSubsidy | Integer | 否 | 出差补助金额(单位:分) |
extra | String | 否 | 额外信息,3000字以内 |
ProjectInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
projectNo | String | 是 | 项目编码 |
projectName | String | 是 | 项目名称 |
CostCenterInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
costNo | String | 是 | 成本中心编码,长度不超过128 |
costName | String | 是 | 成本中心名称 |
ratio | String | 否 | 分摊比例,精度支持最多小数点后四位。多个成本中心分摊比例要么都为空,要么都不为空;若都不为空,数值范围必须在 [0,1] 闭区间内,且分摊比例之和必须为1。 |
customField1 | String | 否 | 自定义字段1 |
customField2 | String | 否 | 自定义字段2 |
customField3 | String | 否 | 自定义字段3 |
customField4 | String | 否 | 自定义字段4 |
customField5 | String | 否 | 自定义字段5 |
StaffInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
entStaffNum | String | 是 | 员工唯一标识 |
name | String | 是 | 员工姓名 |
TripGuestInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
outParticipantId | String | 否 | 外部出行人ID |
name | String | 是 | 外部出行人姓名 |
phone | String | 否 | 外部出行人手机号, 手机号和证件信息必须有一个存在 |
company | String | 否 | 外部出行人所在公司全名 |
position | String | 否 | 外部出行人职位 |
birthday | String | 否 | 出生年月日(pattern:yyyy-MM-dd) |
sex | Integer | 否 | 性别,1:男,2:女 |
tripGuestCardInfos | List<TripGuestCardInfo> | 否 | 外部出行人证件列表 |
TripGuestCardInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
type | Integer | 是 | 证件类型 |
code | String | 是 | 证件号码 |
TripPushItinerary 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
outItineraryId | String | 是 | 外部行程ID |
departureTime | Long | 是 | 出发时间 |
arrivalTime | Long | 是 | 到达时间 |
bizTypes | Set<Integer> | 否 | 品类列表:0不限制,10餐饮,20外卖,30酒店,60打车,100机票,110火车票,-1其他。不传或传空按照0(不限制)处理 |
itineraryType | Byte | 否 | 行程类型:0不限,1单程,2往返。只有按行程维度控时该字段才有效,且只对机票和火车票两个品类有效。 |
departureCitys | List<TripPushItineraryCity> | 否 | 出发城市列表,出发城市个数不能超过50 |
arrivalCitys | List<TripPushItineraryCity> | 否 | 到达城市列表,到达城市个数不能超过50 |
hotelTripRule | HotelTripRule | 否 | 酒店动态差标。只有按行程维度控时该字段才有效。 |
hotelControlInfo | HotelControlInfo | 否 | 酒店管控信息。只有按行程维度控时该字段才有效。 |
flightTripRule | FlightTripRule | 否 | 机票动态差标。只有按行程维度控时该字段才有效。 |
TripPushItineraryCity 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
cityId | String | 是 | 城市编码(国标),枚举数据详见:行政区划查询接口,且仅支持市级和区县级城市,如110100 |
cityName | String | 是 | 城市名 |
cityType | Integer | 是 | 城市类型,1 境内 2境外 |
HotelTripRule 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
isDynamic | Boolean | 否 | 是否动态差标,不传时默认使用静态差标 |
exceedControlType | Integer | 否 | 超标处理方案。200-按照超标处理,填写超标原因,300-拦截预订。默认200 |
exceedAllowPayTypes | List<Integer> | 否 | 超标后允许使用的支付方式,1个人支付,2企业支付,3组合支付 |
budget | Integer | 否 | 每间夜差标上限(单位分):单间酒店的平均价格不得高于该值 |
HotelControlInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
maxRoomnight | Integer | 否 | 最大间夜数量 |
FlightTripRule 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
isDynamic | Boolean | 否 | 是否动态差标,不传时默认使用静态差标 |
cabinDiscounts | List<FlightTripRule.Item> | 否 | 舱位折扣列表,不传时不限舱位 |
exceedControlType | Integer | 否 | 舱位超标处理方案。200-按照超标处理,填写超标原因,300-拦截预订。默认200 |
exceedAllowPayTypes | List<Integer> | 否 | 舱位超标后允许使用的支付方式,1个人支付,2企业支付。默认1 |
FlightTripRule.Item 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
airCabin | Integer | 是 | 舱位:100头等舱,101公务舱,102经济舱 |
discount | Integer | 否 | 折扣,只在airCabin为经济舱时生效。数值为1-10,比如九折传入9。默认10 |
# 1.5 业务响应
名称 | 类型 | 说明 |
---|---|---|
status | Integer | 0: 调用成功,其他值均为: 调用失败 |
msg | String | 失败时的错误描述 |
data | List<Body> | 请求成功时的响应数据,具体为出差申请单ID映射列表 |
Body 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
tripId | String | 否 | 美团企业版出差申请单id |
outTripId | String | 是 | 外部唯一出差申请单id |
result | Integer | 是 | 200: 同步成功,其他值均为: 同步失败 |
msg | String | 是 | 同步成功或失败描述 |
# 1.6 示例
业务请求参数
{
"method":"trip.apply.sync",
"ts":1690977168,
"entId":617,
"tripList":[
{
"outTripId":"5",
"reason":"出差",
"approveStatus":1,
"budgetCode":"123",
"budgetName":"项目名称",
"costCenterCode":null,
"costCenterName":null,
"costCenterInfos":[
{
"costNo":"123",
"costName":"成本中心名称",
"customField1":"自定义字段1",
"customField2":null,
"customField3":null,
"customField4":null,
"customField5":null
}
],
"invoiceTitle":"北京XXX有限公司",
"tripStaffInfos":[
{
"staffId":123,
"entStaffNum":"w123",
"name":"张三"
}
],
"tripGuestInfos":[
{
"outParticipantId":"123",
"name":"李四",
"phone":"13000000000",
"company":"北京三快在线科技有限公司",
"position":"技术专家",
"birthday":"1989-09-03",
"sex":1,
"tripGuestCardInfos":[
{
"type":1,
"code":"512322199802028967"
}
]
}
],
"applyStaffInfo":{
"staffId":123,
"entStaffNum":"w123",
"name":"张三"
},
"tripItineraries":[
{
"outItineraryId":"130500",
"departureTime": 1608134400000,
"arrivalTime": 1608307199000,
"bizTypes":[0],
"itineraryType":0,
"departureCitys":[
{
"cityId":"320500",
"cityName":"石家庄市",
"cityType":1
}
],
"arrivalCitys":[
{
"cityId":"130100",
"cityName":"苏州市",
"cityType":1
}
],
"hotelTripRule": {
"isDynamic": true,
"exceedSolutionType": 200,
"exceedAllowPayTypes": [1,2],
"budget":10000
},
"hotelControlInfo":{
"maxRoomnight":3
},
"flightTripRule": {
"isDynamic": true,
"exceedSolutionType": 200,
"exceedAllowPayTypes": [1,2],
"cabinDiscounts":[
{
"airCabin": 102,
"discount": 9
}
]
}
}
],
"tripSubsidy":0,
"extra":"额外信息"
}
]
}
业务响应
{
"status":0,
"msg":"API处理成功,成功同步差旅申请单数量为1",
"data":[
{
"tripId":"24638",
"outTripId":"4",
"result":200,
"msg":"同步成功"
}
]
}
# 2 企业出差申请单查询
# 2.1 接入说明
美团企业版为客户提供了出差申请、审批功能,如果企业客户希望在美团企业版完成出差申请,但是需要通过接口查询出差申请单信息的功能,则可以通过本文档进行对接。流程如下:
- 企业内部系统发起对美团企业版的接口调用。
- 美团企业版组装出差申请业务数据,返回给企业。
# 2.2 接口说明
名称 | 描述 |
---|---|
功能 | 查询差旅申请单 |
HTTP方法 | POST |
请求方 | 第三方渠道 |
响应方 | 美团企业版平台 |
uri | /trip/applyQuery |
method | trip.apply.query |
# 2.3 公共参数
# 2.4 业务请求参数
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
entId | Long | 是 | 外部企业ID |
tripIds | List<Long> | 否 | 出差申请单ID列表 |
outTripIds | List<String> | 否 | 外部企业出差申请单ID列表 |
submitStaffId | Long | 否 | 出差单提交人StaffId |
tripStaffId | Long | 否 | 出差单出行人StaffId |
createStartTime | Long | 否 | 创建申请单开始时间, 13位时间戳 |
createEndTime | Long | 否 | 创建申请单结束时间, 13位时间戳 |
modifyStartTime | Long | 否 | 修改申请单开始时间, 13位时间戳 |
modifyEndTime | Long | 否 | 修改申请单结束时间, 13位时间戳 |
page | Integer | 否 | 默认为1,页大小为固定值50 |
# 2.5 业务响应
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
status | Integer | 是 | 请求响应码 |
msg | String | 是 | 请求响应信息 |
data | String | 是 | 请求响应数据,内部是Json格式数据 |
Json格式数据说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
page | int | 是 | 当前页码 |
pageSize | int | 是 | 当前页大小 |
pageTotal | int | 是 | 结果集总页数 |
total | int | 是 | 结果集数据总量 |
tripList | List<Trip> | 否 | 行程数据列表 |
Trip 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
tripId | Long | 是 | 出差申请单ID |
applyStaffInfo | StaffInfo | 是 | 出差申请单提交人员工信息 |
tripStaffInfos | StaffInfo | 是 | 出行人员工信息,已过期 |
tripPersonList | List<TripPersonDTO> | 是 | 出行人列表 |
outTripId | String | 否 | 外部唯一出差申请单id(出差单有外部企业内部完成的才有值) |
reason | String | 否 | 出差事由(手动输入) |
selectedReason | String | 否 | 出差事由(下拉选择) |
invoiceTitle | String | 是 | 发票抬头 |
approveType | Integer | 是 | 0: 企业内部完成审批流程,1: 使用美团审批流程 |
approveStatus | Integer | 是 | 1: 通过,0: 删除,-1: 撤回,2: 驳回,3: 审批中 |
tripCities | List<TripCity> | 是 | 出差行程列表 |
flowRecords | List<FlowRecord> | 是 | 审批日志 |
modifiedTime | Long | 是 | 最新更新时间 |
costCenterInfos | List<CostCenterInfo> | 否 | 成本中心列表 |
projectInfos | List<ProjectInfo> | 否 | 项目列表,现状仅支持传一个项目或不传项目 |
belongType | String | 否 | 费用归属于类型,枚举值如下: COST:费用归属于成本中心 PROJECT:费用归属于项目 |
createdTime | Long | 是 | 创建时间 |
ProjectInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
projectNo | String | 是 | 项目编码 |
projectName | String | 是 | 项目名称 |
CostCenterInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
costNo | String | 是 | 成本中心编码 |
costName | String | 是 | 成本中心名称 |
ratio | String | 否 | 成本中心分摊比例,示例0.5表示百分之五十 |
customField1 | String | 否 | 自定义字段1 |
customField2 | String | 否 | 自定义字段2 |
customField3 | String | 否 | 自定义字段3 |
customField4 | String | 否 | 自定义字段4 |
customField5 | String | 否 | 自定义字段5 |
StaffInfo 字段说明
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
staffId | Long | 是 | 10001 | 美团企业版员工id |
name | String | 是 | 张三 | 员工姓名 |
entStaffNum | String | 是 | C20210322 | 企业对该员工的唯一标识 |
TripPersonDTO 字段说明
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
personType | Integer | 是 | 1 | 人员类型:1-员工;2-外部人员 |
personId | Long | 是 | 382712 | 人员ID |
personName | String | 是 | 张三 | 人员姓名 |
sqtOrgId | Long | 否 | 1 | 所在部门ID |
sqtOrgName | String | 否 | 部门 | 所在部门名称 |
sqtOrgPath | String | 否 | 0-1 | 架构链ID |
sqtOrgPathName | String | 否 | 集团-部门 | 架构链名称 |
orgInfo | String | 否 | 组织信息 |
TripCity 字段说明
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
departureCityId | Long | 是 | 110000 | 出发城市编号,境内城市遵循国标,枚举数据详见:行政区划查询接口,且仅支持市级和区县级城市,如110100 |
departureCityName | String | 是 | 北京市 | 出发城市 |
departureCityType | Integer | 是 | 1 | 城市类型,1: 境内,2: 境外,目前仅支持境内 |
departureTime | Long | 是 | 1597823448000 | 出发日期, 13位时间戳 |
arrivalCityId | Long | 是 | 310000 | 到达城市编号,境内城市遵循国标,枚举数据详见:行政区划查询接口,且仅支持市级和区县级城市,如110100 |
arrivalCityName | String | 是 | 上海市 | 到达城市 |
arrivalCityType | Integer | 是 | 1 | 城市类型,1: 境内,2: 境外,目前仅支持境内 |
arrivalTime | Long | 是 | 1597823448000 | 到达日期, 13位时间戳 |
FlowRecord 字段说明
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
operateTime | Long | 是 | 110000 | 操作时间(毫秒数) |
staff | StaffInfo | 是 | 操作人信息 | |
operateType | Integer | 是 | 1 | 操作类型(1:提交,2:重新提交,3:通过,4:驳回,5:撤回) |
operateScene | Integer | 是 | 0 | 审批操作场景(0:美团企业版平台人工触发,1:美团企业版平台系统超时触发,2:外部接口调用触发) |
operateComment | String | 否 | 请假期间不可出差 | 操作备注 |
# 2.6 示例
业务请求参数
{
"method":"trip.apply.query",
"ts":202122222,
"entId":617,
"tripIds":[
24737
],
"outTripIds":null,
"submitStaffId":null,
"tripStaffId":null,
"createStartTime":null,
"createEndTime":null,
"modifyStartTime":null,
"modifyEndTime":null,
"page":1
}
业务响应
{
"msg":"查询成功!",
"data":{
"page":1,
"pageSize":1,
"pageTotal":1,
"total":1,
"tripList":[
{
"tripId":24737,
"applyStaffInfo":{
"staffId":366198,
"name":"dhx",
"entStaffNum":"03137393"
},
"tripPersonList":[
{
"personType":1,
"personId":366198,
"personName":"dhx",
"sqtOrgId":null,
"sqtOrgName":null,
"sqtOrgPath":null,
"sqtOrgPathName":null,
"orgInfo":null
},
{
"personType":1,
"personId":377201,
"personName":"dff",
"sqtOrgId":null,
"sqtOrgName":null,
"sqtOrgPath":null,
"sqtOrgPathName":null,
"orgInfo":null
},
{
"personType":1,
"personId":157880,
"personName":"lhs",
"sqtOrgId":null,
"sqtOrgName":null,
"sqtOrgPath":null,
"sqtOrgPathName":null,
"orgInfo":null
}
],
"tripStaffInfo":{
"staffId":366198,
"name":"dhx",
"entStaffNum":"03137393"
},
"outTripId":null,
"reason":"多人预订",
"invoiceTitle":"北京三快在线科技有限公司",
"budgetCode":"109701",
"budgetName":"差旅费",
"costCenterCode":"180121",
"costCenterName":"基础研发平台_企业平台研发部_平台服务组",
"approveType":1,
"approveStatus":1,
"tripCities":[
{
"departureCityId":"110000",
"departureCityName":"北京市",
"departureCityType":1,
"departureTime":1617206400000,
"arrivalCityId":"310000",
"arrivalCityName":"上海市",
"arrivalCityType":1,
"arrivalTime":1619712000000
}
],
"flowRecords":[
{
"operateTime":1670243899015,
"staff":{
"staffId":111,
"name":"张三",
"entStaffNum":"C20210322"
},
"operateType":1,
"operateScene":0,
"operateComment":"出差需要"
}
],
"modifiedTime":1617171731000,
"createdTime":1617171729000
}
]
}
}
# 3 企业出差申请单推送
# 3.1 接入说明
美团企业版为客户提供了出差申请、审批功能,如果企业客户希望在美团企业版完成出差申请,但是需要美团企业版主动推送出差申请单发生变更的数据推送功能,则可以通过本文档进行对接。流程如下
# 3.2 申请单状态流转说明
# 3.3 接口说明
名称 | 描述 |
---|---|
功能 | 美团企业版主动向企业推送出差申请单变更数据 |
HTTP方法 | POST |
请求方 | 美团企业版平台 |
响应方 | 第三方平台 |
url | 第三方提供 |
method | trip.apply.push |
# 3.4 公共参数
# 3.5 业务请求参数
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
data | Object | 是 | 推送数据实体 |
推送数据实体字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
tripId | Long | 是 | 出差申请单ID |
applyStaffInfo | StaffInfo | 是 | 出差申请单提交人员工信息 |
tripStaffInfos | StaffInfo | 是 | 出行人员工信息,已过期 |
tripPersonList | List<TripPersonDTO> | 是 | 出行人列表 |
outTripId | String | 否 | 外部唯一出差申请单id(出差单有外部企业内部完成的才有值) |
reason | String | 否 | 出差事由(手动输入) |
selectedReason | String | 否 | 出差事由(下拉选择) |
invoiceTitle | String | 是 | 发票抬头 |
approveType | Integer | 是 | 0: 企业内部完成审批流程,1: 使用美团审批流程 |
approveStatus | Integer | 是 | 1: 通过,0: 删除,-1: 撤回,2: 驳回,3: 审批中 |
tripCityList | List<TripCity> | 是 | 出差行程列表 |
modifiedTime | Long | 是 | 最新更新时间 |
costCenterInfos | List<CostCenterInfo> | 否 | 成本中心列表 |
projectInfos | List<ProjectInfo> | 否 | 项目列表,现状仅支持传一个项目或不传项目 |
belongType | String | 否 | 费用归属于类型,枚举值如下: COST:费用归属于成本中心 PROJECT:费用归属于项目 |
createdTime | Long | 是 | 创建时间 |
ProjectInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
projectNo | String | 是 | 项目编码 |
projectName | String | 是 | 项目名称 |
CostCenterInfo 字段说明
名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
costNo | String | 是 | 成本中心编码 |
costName | String | 是 | 成本中心名称 |
ratio | String | 否 | 成本中心分摊比例,示例0.5表示百分之五十 |
customField1 | String | 否 | 自定义字段1 |
customField2 | String | 否 | 自定义字段2 |
customField3 | String | 否 | 自定义字段3 |
customField4 | String | 否 | 自定义字段4 |
customField5 | String | 否 | 自定义字段5 |
StaffInfo 字段说明
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
staffId | Long | 是 | 10001 | 美团企业版员工id |
name | String | 是 | 张三 | 员工姓名 |
entStaffNum | String | 是 | C20210322 | 企业对该员工的唯一标识 |
TripPersonDTO 字段说明
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
personType | Integer | 是 | 1 | 人员类型:1-员工;2-外部人员 |
personId | Long | 是 | 382712 | 人员ID |
personName | String | 是 | 张三 | 人员姓名 |
sqtOrgId | Long | 否 | 1 | 所在部门ID |
sqtOrgName | String | 否 | 部门 | 所在部门名称 |
sqtOrgPath | String | 否 | 0-1 | 架构链ID |
sqtOrgPathName | String | 否 | 集团-部门 | 架构链名称 |
orgInfo | String | 否 | 组织信息 |
TripCity 字段说明
名称 | 类型 | 是否必填 | 示例 | 说明 |
---|---|---|---|---|
departureCityId | String | 是 | 110000 | 出发城市编号,境内城市遵循国标,枚举数据详见:行政区划查询接口,且仅支持市级和区县级城市,如110100 |
departureCityName | Long | 是 | 北京市 | 出发城市 |
departureCityType | Integer | 是 | 1 | 城市类型,1: 境内,2: 境外,目前仅支持境内 |
departureTime | Long | 是 | 1597823448000 | 出发日期, 13位时间戳 |
arrivalCityId | String | 是 | 310000 | 到达城市编号,境内城市遵循国标,枚举数据详见:行政区划查询接口,且仅支持市级和区县级城市,如110100 |
arrivalCityName | Long | 是 | 上海市 | 到达城市 |
arrivalCityType | Integer | 是 | 1 | 城市类型,1: 境内,2: 境外,目前仅支持境内 |
arrivalTime | Long | 是 | 1597823448000 | 到达日期, 13位时间戳 |
# 3.6 业务响应
名称 | 类型 | 说明 |
---|---|---|
status | Integer | 0: 调用成功 其他值均为: 调用失败 |
msg | String | 失败时的错误描述 |
data | String | 额外数据,无具体含义 |
# 3.7 示例结果
{
"status": 0,
"msg": "success",
"data": {}
}
{
"status": 1,
"msg": "参数校验失败",
"data": {}
}