取消规则（城市、车型）

简介

本接口用于查询订单的取消规则文本。

服务提供方

享道

接口URL

/openapi/cancel/rule-v2

请求方式

POST

请求频次

单次

请求参数

参数名称	类型	必选	说明
timestamp	long	是	请求时间，Unix Timestamp单位毫秒
product_type	string	是	产品类型，参见附录1
ride_type	string	是	运力类型，参见附录1
city_code	string	是	城市code，默认为出发地所在城市city_code参见附录6
service_id	int	是	服务类型，参见附录2
order_id	string	否	享道订单id
oid	string	否	合作方订单id

响应参数

参数名称	类型	必有	说明
errCode	int	是	服务响应状态，参见附录5
errMsg	string	是	服务响应状态说明，参见附录5
content	object	是
content.passengerNoResponsibilityCancelDuration	int(秒)	是	乘客免责取消时间(代表司机接单后X分钟内，乘客可以免责取消订单)
content.driverFreeWaitingTime	int(秒)	是	司机免费等待时间(代表司机到达目的地后需要免费等待乘客X分钟，期间不收取等待费)
content.reservationNoResponsibilityCancelDuration	int(秒)	是	预约用车时间前免责取消时间(实时单不传。代表预约用车时间前X分钟外，乘客可以免责取消订单)
content.order_id	string	否	享道订单ID
content.oid	string	否	合作方订单id
content.rules	list	是	规则文本列表
content.rules.text	string	是	规则文本

请求示例

请求

curl --location --request POST 'https://open-sit.saicmobility.com/merchant/v1/openapi/cancel/rule' \
--header 'X-Sign: f79f59997530992a9849f8bf9b0018c0f9254a80' \
--header 'X-SignAlgorithm: 1' \
--header 'X-Timestamp: 20201020193600' \
--header 'X-MerchantId: open_app_Eg77IK8qngB97nOP' \
--header 'Content-Type: application/json' \
--header 'Cookie: tgw_l7_route=9f8624a08e89ffc3ab36b4b3b429fa88' \
--data-raw '{"timestamp":1603192859627,"service_id":1,"ride_type":"compact","product_type":"private-car","city_code":"021"}'

响应

{
  "errCode": 10000,
  "errMsg": "successful",
  "content": {
    "oid": "Tessm6g2nhb1l5qgu64upcbanfvhy32g5xt7",
    "order_id": "U4b3w6n9w11e646041c0114128add91397193c0e66",
    "rules": [
      {
        "text": "乘客取消付费规则：乘客在司机接单0分钟后取消订单，需支付司机取消费1.00元。司机按时到达上车点，且等待超过0分钟，司机可免责取消订单，乘客需支付司机取消费6.00元。"
      },
      {
        "text": "乘客取消免费规则：乘客在司机接单后0分钟内，可免责取消订单。司机未在规定时间内到达上车点，乘客可免责取消订单。若司机原因造成，如司机迟到、拒载等行为，乘客无需支付取消费。"
      },
      {
        "text": "取消费的用途：平台向乘客收取的所有取消费，都将全额用于补偿司机的空驶。"
      }
    ]
  }
}