# 事件响应

# 简介

本接口用于订单触发了某个既定事件之后(目前只有确认订单事件),合作方将事件同步给享道,保证双方订单状态和数据的一致性。

# 服务提供方

享道

# 接口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"
}