# 事件响应
# 简介
本接口用于订单触发了某个既定事件之后(目前只有确认订单事件),合作方将事件同步给享道,保证双方订单状态和数据的一致性。
# 服务提供方
享道
# 接口URL
/openapi/event/notify
# 请求方式
POST
# 请求频次
单次
# 请求参数
参数名称 | 类型 | 必选 | 说明 |
---|---|---|---|
timestamp | long | 是 | 请求时间,Unix Timestamp单位毫秒 |
order_id | string | 是 | 享道订单ID |
oid | int | 是 | 合作方订单ID |
event_type | string | 是 | 事件类型 |
contact_bind_type | int | 否 | 联系方式绑定模式 1-下单绑定 2-成单绑定 |
user_phone | string | 否 | 叫车人真实号,11位数字,不含特殊符号。 代叫单真实号下单时必传 |
user_mask_phone | string | 否 | 叫车人掩码号码,11位字符,最后4位必须为数字,如:132****3333。代叫单虚拟号下单时必传 |
user_virtual_phone | string | 否 | 叫车人虚拟号,user_phone为空时使用此字段。代叫单虚拟号下单时必传 |
passenger_phone | string | 否 | 乘车人手机,11位数字,不含特殊符号。真实号下单时必传 |
passenger_mask_phone | string | 否 | 乘车人掩码号码,11位字符,最后4位必须为数字,如:132****3333。虚拟号下单时必传 |
passenger_virtual_phone | string | 否 | 乘车人虚拟号,passenger_phone为空时使用此字段。虚拟号下单时必传 |
latest_dispatch_time | string | 否 | 渠道认定的最晚派单时间 |
car_use_time | string | 否 | 渠道认定的用车时间 |
flight_info | object | 否 | 渠道认定的航班时间 |
flight_info.flight_no | string | 否 | 航班号 |
flight_info.flight_time_from | string | 否 | 航班起飞时间 |
flight_info.flight_time_to | string | 否 | 航班降落时间 |
# 响应参数
参数名称 | 类型 | 必有 | 说明 |
---|---|---|---|
errCode | int | 是 | 服务响应状态,参见附录3 |
errMsg | string | 是 | 服务响应状态说明,参见附录3 |
# 事件编码
事件类型 | 触发条件 | 订单后续状态 | 事件说明 |
---|---|---|---|
ORDER_ACCEPTED | 司机接单状态下,合作方确认享道接单 | 司机接单 | 享道回调接单后,合作方通过这个事件通知来确认享道接单成功 |
MERCHANT_TIME_CHANGED | 渠道收到享道【延迟派确认接单】后,信息时间节点发生变更后同步享道 | 订单关键时间节点变更 | 订单免费取消时间前,渠道将会同步该信息,支持变更 |
# 请求示例
请求
curl --location --request POST 'https://open-sit.saicmobility.com/merchant/v1/openapi/event/notify' \
--header 'X-Sign: aab078dd08a60c2a2e72bbbdfca3c9f94ab40e13' \
--header 'X-SignAlgorithm: 1' \
--header 'X-Timestamp: 20201021113700' \
--header 'X-MerchantId: open_app_OqPcV19dBV1KoBHs' \
--header 'Content-Type: application/json' \
--data-raw '{"timestamp":1603196471352,"oid":"Tess6k2qvpt5wqduk9zqhwlhwhi04k8llmdp","order_id":"U4b3x6n9w2faf6cbf75ab141cab93096f29a842f23","event_type":"ORDER_ACCEPTED"}'
响应
{
"errCode": 10000,
"errMsg": "successful"
}