神州专车开放平台

## API模式快速接入
该章节让开发者以最快的速度，完成整个叫车服务流程的接入。在此需之前需要完成以下操作：

1. 完成<a href="doc?r=guide/content#第一步：接入准备">接入准备</a>
2. 完成<a href="doc?r=guide/content#授权码模式授权（authorization-code）">授权码模式认证授权</a>

神州专车接口较多，用车主流程及对应API接口如下：

通过以上操作获取`客户端ID`、`客户端密钥`，并通过`OAuth2.0`授权码模式授权后获得`access_token` 。接下来参照H5模式进行最小版本接入

### 第一步：获取产品总类和城市Id
通过调用产品总类接口 <a href="doc?r=api/content#产品总类">/v1/resource/common/getCityService</a> 获取数据。如下：
```
{
    busiCode: "BASE000",
    code: 1,
    content: {
        cityId: 1,
        cityName: "北京",
        services: {
            7 : {
                id: 7,
                name: "接机"
            },
            8 : {
                id: 8,
                name: "送机"
            },
            11 : {
                id: 11,
                name: "包车（4小时）"
            },
            13 : {
                id: 13,
                name: "预约用车"
            },
            14 : {
                id: 14,
                name: "立即叫车"
            }
        }
    },
    msg: "成功",
    status: "SUCCESS",
    uid: "1e4e49a6-5cf2-4900-bc0d-bd8077d10ce11455413029357",
    version: "001"
}
```

### 第二步：根据服务类型的Id和城市Id获取服务车型
通过调用产品信息接口 <a href="doc?r=api/content#产品信息">/v1/resource/common/getCityServiceDetail</a> 获取数据，在这里我们使用 `立即叫车` 城市使用`北京`，传入对应的Id
<div class="text-center" style="display:none"><img src="#" id="html5-main" data-load-path="/img/h5-pic/now_order.png"><div class="text-center input-tips">参考图</div></div>

+ 注意：其他服务类型参数或流程中规则可能不一致，但主流程基本是一样的。如有疑问请先阅读文档或<a href="doc?r=faq/contact">联系我们</a>

### 第三步：完成立即叫车流程
#### 1. 预估费用与下单
下图展示了下单的主要流程，预估费用时如果有需要代金券的开发者需要调用`代金券(coupon)` <a href="doc?r=api/content#费用预估-1">/v1/resource/common/estimate/priceWithCoupon</a>接口，
使用前请先阅读该接口的`注意事项`。关于黑名单请参考 <a href="doc?r=faq/content#q：您的操作违规，请2小时后再试？">您的操作违规，请2小时后再试？</a>

叫车之前，我们的账号可能没有余额，在测试环境中我们先调用 <a href="doc?r=guide/content#1-账户充值">/v1/action/user/recharge</a> 接口进行充值

涉及接口：
+ <a href="doc?r=api/content#费用预估">/v1/resource/common/estimate/price</a>
+ <a href="doc?r=api/content#创建订单">/v1/action/order/create</a>

<div class="text-center" style="display:none">
    <img src="#" id="html5-main" data-load-path="/img/h5-pic/now_order_flow_thum.png" data-href-path="/img/h5-pic/now_order_flow.pdf">
    <div class="text-center input-tips">预估费用流程图</div>
</div>

#### 2. 派单与订单状态变更
下单成功后，司机进行接单。需要注意的是`余额不足5分钟内需要进行充值`的情况下调用了[/v1/action/user/recharge（该接口只存在于测试环境）](doc?r=guide/content#1-账户充值)接口充值成功将不会起到联动的作用，`5分钟后还是会取消订单`

如需联动请使用 [/v1/action/tradingplatform/recharge](doc?r=api/content#充值) 接口进行充值（注意在此情况下参数中的`orderId`不需要传入），该接口适用于正式环境和测试环境

正式环境下，`dispatched` 之后`paid` 之前的订单状态由司机驱动（非取消状态）<br/>
测试环境下，我们可以调用 [/v1/action/order/changeStatus](doc?r=guide/content#2-变更订单状态接口（模拟司机接单）) 将订单状态进行变更

当订单状态变化时将会发生回调。请参考：<br/>
+ <a href="doc?r=guide/content#关于订单状态回调通知">关于订单状态回调通知</a>

下图展示了订单生命周期的状态以及驱动状态的对象，对应状态的说明参考<a href="doc?r=guide/content#1-订单状态">订单状态</a>
<div class="text-center" style="display:none">
    <img src="#" id="html5-main" data-load-path="/img/order_status_flow.png" data-href-path="/img/order_status_flow.png">
    <div class="text-center input-tips">订单状态</div>
</div>

#### 3. 支付与评价
司机提交费用后订单状态为`feeSubmitted` 可进行支付

请参考：<br/>
+ <a href="doc?r=faq/content#q：订单服务完成后，如何进行支付？">订单服务完成后，如何进行支付？</a> <br/>
+ <a href="doc?r=faq/content#q：订单如何进行评价？">订单如何进行评价？</a>

### 取消订单
请参考：<br/>
+ <a href="doc?r=faq/content#q：订单下单后，在什么时间可以取消？">订单下单后，在什么时间可以取消？</a>

加载中...

神州专车开放平台登录

邮箱
密码
验证码

验证码错误

记住账号忘记密码？