接入流程
一、注册开发者账号
- 进入开发者管理中心,注册开发者账号,网址为 http://open.caocaokeji.cn/ocean/login
- 填写开发者手机号和企业名称进行注册
二、创建沙箱应用
- 创建应用,填写应用名称、应用类型、接入模式、所需API、回调地址。注意:若使用「第 5 章」H5用车,则不要配置白名单
- 创建应用成功后,点击【查看详情】,获取client_id和sign_key
- 点击【调试】可进行接单调试、回调测试、签名验证、接口MOCK
- 3.1 接单调试:开发者进行用车主流程调试时,需通过曹操司机端完成订单服务流程,司机测试账号在此页议添加,具体添加注意事项见文档1.2章节
- 3.2 回调测试:用于测试对接方回调地址是否可正常使用
- 3.3 签名验证:用于验证签名生成是否正确,务必保证此步骤调通
- 3.4 接口MOCK:开发者在沙箱环境调试时,已开通权限的接口若开启“返回参数mock”开关,则请求对应接口后,返回的参数为开发者自定义的返回参数(若请求接口因服务异常不通时可使用mock模式)
三、申请正式应用,你需要创建另一个企业账户,用来维护你的充值或授信
- 打开曹操企业版官网注册企业账户,网址为 http://www.vipcaocao.com/login
- 在之前的开发者管理中心内申请正式应用,填写应用名称、应用类型、应用描述、接入模式、开发人员手机号、邮箱、所需API
- 工单提交上线申请至曹操方,曹操方进行审核。
- 线上验收通过后,请告知曹操方,曹操方会进行一些上线准备,完成后,即可正式上线(线上验证只能通过线上真实下单完成)
上线申请模板【请提交工单(路径:开发者管理中心-应用-问题反馈)】
企业名称:第1点注册的企业账户名+企业ID(企业ID咨询客户经理),比如杭州优行科技有限公司(001)
client-id:生产应用的client-id,点击应用【查看详情】获取client_id
回调地址:线上回调地址曹操运维需要审核,提交工单时一起提供
上线时间:比如2020-12-12 下午
四、其他
- 地图服务请使用高德地图
- 反馈问题请把对应环境、请求返回日志、具体问题通过技术对接群发送给曹操技术同学
- 沙箱环境计价规则数据均为虚拟数据,上线后以线上计价规则数据为准
- 开始对接前,请认真阅读接入流程、FAQ和相关接口文档
- 禁止接入方在沙箱和线上环境做接口压测,影响曹操线上服务稳定将会追责