如何使用

第一步：添加运营商

点击 沙箱环境进入曹操充电桩沙箱环境登录页，首次使用需要先行注册。登录后，点击右上角的添加运营商，填写必填信息添加一个运营商用于调试。

添加运营商界面:

重要字段解释：

1. 运营商名称：请填写一个简称（5个字内），创建后无法修改。

2. 城市编码：参考国标，填写运营商所在地的城市编码。

3. 服务地址(沙箱): 是该运营商的测试环境服务地址,需要完整带上http://或https://,末尾以"/"结尾，如：https://sandbox.caocaokeji.cn/。

4. 二维码信息：

      运营商标识（必须）：二维码信息中需要包含运营商唯一标识，曹操会根据标识识别出这个二维码是属于该运营商的，从而调用该运营商的接口。
      桩编号（必须）：二维码信息中必须包含桩编号，需要确认是哪个桩。
      枪编号（可选）：如果一个桩只有一个枪，则无需提供，如一桩多枪，则尽可能提供枪编号，否则用户扫了这个枪的码，还是会让弹出框用户手动选择哪个枪进行充电。
      如 hlht://桩编号-枪编号.运营商ID/
   

5. 文本扫码规则说明：请详细描述二维码信息中每部分的含义；如，哪部分代表运营商ID，哪部分代表桩编号、枪编号；

成功添加运营商后，在列表页便出现了该运营商。

第二步：调试

    首先在列表页找到自己要调试的运营商

    状态介绍，联调开始至完成所要经历的所有状态：

        1.联调中：初始状态，沙箱环境与运营商测试环境进行联调。
        2.线上验证申请：运营商联调完成，接口调通后可以申请线上验证，此时状态变为“线上验证申请”。
        3.线上验证中：线上验证申请会提交给曹操运营人员审核，再确认接口调通后，状态会变为“线上验证中”。此时，可以开放部分站点在线上测试。
        4.上线申请：线上测试完成后，运营商可以申请上线，此时状态变为“上线申请”。
        5.已上线：等待曹操运营人员确认可以上线后，会更改状态为“已上线”。届时司机可在曹操司机端使用该运营商进行充电。

联调开始之前，先点击查看沙箱秘钥，将程序的对应appId、appKey、appSecret、dataSecret、dataSecretIV替换为沙箱的，回调地址也切换成沙箱提供的。

调试：

调试阶段分两个模块：

* 模拟API调用：单个接口校验。
* 充电流程校验：整体接口自动化串行校验。

请先保证单个接口校验均通过时再进行充电流程校验，保证过程中出现奇奇怪怪的问题导致流程卡住。

​ 每个接口校验均是根据开放平台的标准进行定义，根据提示传递响应参数，点击提交，便会发送请求并校验返回，将最终的结果输出在下方。

校验成功会显示：成功。

校验失败会显示：相应的错误原因。具体错误原因参考可详见**QA**。

线上验证申请

联调完毕后，可点击上线申请，输入线上服务地址，便进入线上验证环节。

    申请线上验证时，需要填写验证站点信息。包括站点所在城市，站点名称；并填写线上服务地址。

线上验证

线上验证时需要将appId、appKey、appSecret、dataSecret、dataSecretIV等参数切换为线上参数，在列表页点击查看线上秘钥查看。并将回调地址修改为曹操线上地址https://biz.caocaokeji.cn/dic-gateway/caocao/v2/notify/open

此环节与联调中内容相同，仅仅是运营商服务地址从测试切换到线上，验证线上服务是否正确、稳定。

验证站点

    可根据实际情况，修改用户测试的**验证站点**信息；其中城市编码需要用应为括号括起来，示例：杭州(1111)

线上验证中

    线上验证申请状态下，需要等待曹操运营人员进行一些配置，状态才会变为线上验证中。之后配合曹操对验证站点进行测试，观察整体流程数据是否正常、订单金额是否准确；

第三步：上线

上线申请

    待线上验证无问题后，运营商可发起“上线申请”，等待上线；

已上线

    待曹操运营人员完成基础配置，会将状态变更为“已上线”，届时司机可在曹操司机端使用该运营商进行充电。

​