神州专车开放平台

## 授权认证
#### Q：授权码模式授权时，code可以重复使用吗？
* A：code是随机生成的，且只能使用一次，使用过后，不管成功与否，此code都会作废，下次需要使用新的code进行token的申请。code的有效期为10分钟。

#### Q：access_token失效后，是否要重新走一次授权流程获取access_token？
* A：access_token失效后，可以通过refresh_token重新获取access_token，如果refresh_token也失效了，则必须再重新进行一遍授权流程。

#### Q：请求开放平台接口时是使用get还是post方式呢？
* A：建议使用post方式对开放平台进行请求。

#### Q：refresh_token的有效期是多长时间？
* A：refresh_token的默认有效期为30天，可以通过“应用管理”→”刷新令牌有效期”配置项进行设置，最长可设置成90天。

#### Q：认证过程中，redirect_url的作用是什么？
* A：在 Oauth2.0协议中，用户同意授权自己的信息后，系统会将code（即授权码）发送到redirect_url所在的地址，而后可以使用获取到的code访问Oauth服务器获取access_token（建议这个步骤在服务端完成），进而完成整个认证过程。

#### Q：获得code后，在获取access_token时，为什么报401（未经授权）错误？
* A：这是由于session过期了，在登录成功并获取code后，要尽快获取access_token。

#### Q：refresh_token可以自己刷新吗？
* A：通过线上环境申请的开放平台账号，将不具备refresh_token自动刷新的权限，若有特殊的使用场景，需要长久持有客户信息，<a href="?r=faq/contact" target="_blank">请联系我们</a>。

#### Q：https获取access_token的方式是哪种？
* A：目前只支持通过post方式进行获取。

#### Q：完善个人信息时，订单状态变化回调URL和授权时的重定向URL可以相同吗？
* A：可以相同，只要该地址可以同时处理两个业务场景即可

#### Q：是否可以在获取授权码的时候添加一些自定义参数？
* A：在调用”/authorize”申请授权时，在请求URL最后添加上&state=参数值，就可以在跳转到重定向URL地址时，将自定义参数带回。

## 开放平台配置
#### Q：开放平台接口有请求频率限制吗？
* A：目前每个接口，每个用户5秒内可以访问50次。

#### Q：开发环境也需要绑卡吗？
* A：为了方便开发测试，通过线上环境申请的开放平台账号，在生产环境将会要求客户绑定信用卡，若有场景需要客户无需绑定信用卡使用专车服务，<a href="?r=faq/contact" target="_blank">请联系我们</a>。

## 订单相关
#### Q：订单下单后，在什么时间可以取消？
* A：用户下单后，在司机开始服务前(订单状态为“serviceStarted”)都可以取消订单。不同的是，在司机到达后取消订单，会产生违约金（由神州定价），而在司机到达前取消，不会产生任何费用。需要注意的是，频繁取消订单将有可能进入我司的黑名单，将不能继续进行下单操作。

#### Q：订单服务完成后，如何进行支付？
* A：订单服务完成，且司机提交完费用后，系统会自动扣除客户自身余额，或信用卡资金。

#### Q：服务过程中的页面变化怎样实现？
* A：通过设置“应用管理”->”授权”->” 订单状态变化回调URL”，订单状态变化时，将通知到该URL对应的服务器，您可以根据此通知，进行业务处理。或者可以采用定时轮询的策略调用“订单详情”接口来查询订单状态是否发生变化。

#### Q：派单会持续多长时间？
* A：如果是立即派单类订单，派单动作最长持续120秒，如果120秒内没有成功派单，则订单变为无效状态。

#### Q：订单下单后是否会自动取消？规则是什么？
* A：如果用户下的订单金额较高，用户账户的余额不足以支付，且也没有绑定信用卡， 则用户需要在5分钟之内进行充值，否则系统会从司机接单开始计算时间， 5分钟后自动取消订单。

#### Q：如何确定订单是否已经派单成功？
* A：当订单状态回调URL收到通知状态为“dispatched”，或者调用“订单详情”接口，订单状态为“dispatched”或之后的状态，则表示已经派单成功。

#### Q：新建一个订单后，怎样判断是派单中还是派单失败？
* A：新建订单后，如果订单状态是“created”则，表示是派单中；如果订单状态为“invalid”，则表示派单失败。

#### Q：下单成功后，如果附近没有空闲车辆，订单会变成什么状态？
* A：120秒派单无人接单后，订单会变为“invalid”状态

#### Q：预约用车提前多长时间开始派单？
* A：预约用车的派单时间根据各地区的运力情况会有不同，默认情况下为提前30分钟开始派单。

#### Q：预约用车的用车时间必须在30分钟后吗？
* A：预约用车也可以预约30分钟内的订单，如果预约用车的时间小于最小派单间隔（例如30分钟，下同），则会立即进行派单；同时立即叫车也可以下30分钟后的订单，如果立即叫车的用车时间超过最小派单间隔，则不会立即派单，而是等到时间在最小派单间隔内时再进行派单。

#### Q：什么是疑议订单？
* A：用户对订单的服务或费用有疑议可通过神州专车APP或神州专车客服平台进行订单疑议（司机费用提交后-订单完成状态前可疑议），订单疑议后订单状态将不会自动变更（支付、完成）。待我们客服进行疑议处理后订单状态才可以变更。

#### Q：乘车人正在进行中订单限制
* A：每个乘车人不能有超过3个带服务的订单。

#### Q：账户余额会冻结多长时间？
* A：在订单结算完成前，会一直冻结。

#### Q：订单如何进行评价？
* A：为了尽量简化用车流程，通过线上环境申请的开放平台账号，默认情况下将采用系统48小时自动评价的机制。若需要增加手动评价的场景，<a href="?r=faq/contact" target="_blank">请联系我们</a>。

#### Q：创建订单时为什么返回可冻结金额不足？
* A：已经存在未完成的订单冻结了所有余额，导致新建订单时没有足够的余额进行冻结操作，将不能创建订单。

#### Q：经常夜间收到大量回调？
* A：夜间会有自动任务执行，有些任务会导致订单状态发生改变，所以会有回调发生。

#### Q：刚创建的订单在订单列表里面看不见？
* A：为了模拟司机接单，测试环境对尚未派单成功的订单做了特殊的处理，导致订单列表无法查看，生产环境不会出现此类问题。

#### Q：无效订单还需要做其他处理吗？
* A：无效订单不需要做任何处理 ，同已取消、完成的订单一样，都属于订单的最终状态。

#### Q：回调失败了会重试吗？
* A：3秒内如果回调没有响应，立即重试1次。

#### Q：测试环境订单详情中司机经纬度都是0？
* A：测试环境中司机都是模拟的，没有真实打点数据，所以司机经纬度都是0。

#### Q：您的操作违规，请2小时后再试？
* A：取消订单次数过于频繁会被拉入临时黑名单，两小时后自动解除拉黑。
 订单状态在已派单 、已到达、已出发 ，一小时取消次数大于5次以上拉入黑名单。
 订单状态在已新建，一小时取消次数大于10次以上拉入黑名单。
 以上2种规则不会累加计算取消次数。 
 备注：使用企业超级管理员手机号叫车不受黑名单规则限制，不会加入到黑名单里。

#### Q：神州开放平台接口的经纬度采用的是什么坐标系统？
* A：高德（腾讯）地图坐标系。

#### Q：在测试环境下订单的时候，在什么位置才会有司机接单？
* A：天津市空港商务园东区有测试司机接单。

## 企业相关
#### Q:创建企业订单时候提示“当前用户与企业id不匹配”
* A：正式环境请登录 <a href="http://my.10101111.com/company/index.do" target="_blank">神州专车企业服务</a> > 员工管理，将订车人（登录用户）手机号加入企业当中。测试环境<a href="?r=faq/contact" target="_blank">请联系我们</a>。

## 新计价规则相关
#### Q：不使用新计价规则会有什么影响？
* A：我司新计价规则体系上线后，会有一段时间的缓冲，在该缓冲时间内，兼容老的计价规则，即该时间段内，不会有影响。 
等到我司强制使用新计价规则后，如果继续使用老的计价规则，接口层面可能会因响应数据格式改变而出现错误。
#### Q：新计价规则新增的 basePriceSchemeId 字段具体有什么含义？
* A：新的计价规则是分时段计费的，不同时段，费用可能不同，basePriceSchemeId 代表的是有效时间段内（比如：2019-12-01 ~ 2019-12-30）的不同车组不同时间段（比如 10:00~12:00, 12:00~14:00）的费用。
#### Q：新计价规则新增的 basePriceSchemeId，此id是否会变更，如果会变更有效期多久?
* A：存在方案id变更情况，具体周期及频率<a href="?r=faq/contact" target="_blank">请联系我们</a>。
#### Q：产品信息接口中，返回的priceDateType(1-休息日，2-平日) 字段具体有什么含义？
* A：比如2019-12-11对司机来说是工作日，2019-12-14对司机来说是休息日，则两个日期的计价规则是不一样的。
#### Q：产品信息接口新增两个参数 departureTime 和 basePriceSchemeId，两个参数都是必传的吗？
* A：两个参数二选一即可，全部传入则以basePriceSchemeId 为准。
#### Q：新计价规则对用车流程有没有影响？
* A： 
使用新计价规则之后，一般的创建订单流程如下： 
1）调用 产品总类接口 获取 services.id 和 services.basePriceSchemeId（basePriceSchemeId有失效风险，失效后需要重新获取最新） 
2）调用 产品信息接口获取产品计价规则，该接口新增departuretime 和 basePriceSchemeId 入参，两个入参二选一即可，全部传入则以basePriceSchemeId 为准。 
3）调用 预估接口获取预估报价，接口新增basePriceSchemeId 入参，非必传，不传则以出发时间获取实时的预估价。（如果传入basePriceSchemeId ，可能会提示“基础价格方案id错误”，
此时判断busiCode 是否为schemeIdInvalid，如果为true，重新调用<a href="doc?r=api/content#产品总类-–-适用新报价体系" target="_blank">产品总类接口</a>，获取最新的basePriceSchemeId） 
4）调用 创建订单接口 
 
简易的创建订单流程如下： 
1）调用 预估接口获取预估报价，接口不传basePriceSchemeId 入参，获取实时的预估价。 
2）调用 创建订单接口
#### Q：使用新计价规则之后的费用计算公式有改变吗？
* A：有的，旧的计算公式中的远途费、出城费和路桥费去掉了，新的计算公式增加了远程费。
#### Q：每次请求预估费用接口都要先从产品总类接口取basePriceSchemeId吗?
* A：不用，如果没有向用户展示最新的计价规则的场景，可以不用获取basePriceSchemeId，即预估接口可以不传basePriceSchemeId。
#### Q：切换到新计价规则之后，是所有城市都适用吗？
* A：是的，但是如果某个城市没有配置新计价规则的方案，就无法下单，需要联系我们商务。

加载中...

神州专车开放平台登录

邮箱
密码
验证码

验证码错误

记住账号忘记密码？