1.文档说明

九官

414字约1分钟

2023-01-13

基本说明

请求域名

联调环境: https://custopen.jiuguanqifu.com/test

线上正式环境: https://custopen.jiuguanqifu.com/prod

1. 对接操作流程

  1. 登录平台,进入首页获取访问地址,首页可查看相关URL,参数等信息;

    image-20240530112358703

  2. 创建子账号,选择需要开通的套餐;

  3. 创建坐席,注意该步骤必须绑定对应的子账号;

  4. 调用获客跳转URL接口,具体接口地址请参考相关的接口说明;

  5. 解锁获客数据,开放平台定时推送解锁获客数据到调用方;

  6. 接口请求方式,接口不做特殊说明默认为POST请求,请求 Content-Type:application/json

image-20240515140403039

2. HTTPS 标准报文头字段

Accept:application/json
Content-Type:application/json;charset=utf-8
appkey:总账户的appkey
timestamp:13位的时间戳(精确到毫秒)
sign:签名
nonce:随机字符串

各属性说明:

appkey:总账号的appkey

timestamp:13位的时间戳(精确到毫秒),

sign:签名参数,规则详见 签名说明章节

nonce:不小于10位的随机字符串,用来判断是否为重复请求

全局异常码

错误码说明
100001认证失败
100002时间戳字段缺失
100006appKey无效
100007签名参数无效
100008appKey非法
100009请求已过期
100010nonce不能为空
100011重复的请求
100012企业不存在
100013企业账号已禁用

九官