云服务器内容精选

  • 响应说明 参数名称 数据类型 参数位置 必选/可选 描述 errorCode int body True 错误码 0:成功 非0表示失败 或可通过状态码为200判断为成功 errorMsg String body False 错误描述 authToken String body True 认证token expireTime int body False 令牌有效期,单位是秒数,默认 3600 秒; 错误码非0时,无返回。
  • 报文样例 请求消息体 { "appKey": "tenant001", "appSecret": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } 响应消息体 { "errorCode" : 0, // int, 错误码,无错时为0 "errorMsg" : "", // String, 出错信息,无错时为空 "authToken": "2************************", "expireTime" : 3600 }
  • 静态鉴权 在agentgateway/WEB-INF/config/basic.properties中修改配置: AUTHMODE = 1 座席调用登录接口登录成功后,可以从请求的响应头中获取到名称为Set-GUID的header,值例如为“JSESSIONID=27************f5.AgentGateway0”,其中27************f5.AgentGateway0为guid,这个guid就是这个座席的鉴权信息。座席调用其他接口时需要将该guid设置到http请的header中,header的名称必须为guid。CC-Gateway会从请求的header中获取guid进行比较,判断是否合法用户,如果不是合法用户,则返回结果码为100-006或000-003。
  • AK/SK获取方式 AK/SK认证 AK/SK认证就是使用AK/SK对请求进行签名,在请求时将签名信息添加到消息头,从而通过身份认证。 AK(Access Key ID):访问密钥ID。与私有访问密钥关联的唯一标识符;访问密钥ID和私有访问密钥一起使用,对请求进行加密签名。 SK(Secret Access Key):与访问密钥ID结合使用的密钥,对请求进行加密签名,可标识发送方,并防止请求被修改。 使用AK/SK认证时,您可以基于签名算法使用AK/SK对请求进行签名。 私有AK、SK获取方式 集成环境:请联系运营人员获取。 接口鉴权如果通过 ,则https响应码为200;如果不通过,则https的响应码为401。
  • 响应说明 表3 消息体参数说明 序号 名称 参数类型 说明 1 message string 响应消息描述 2 retcode string 错误码。取值如下: 0:成功 非0:失败,具体见“错误结果码”章节 3 result object 结果内容对象。该对象参数说明请参见表4。 表4 result参数说明 序号 名称 参数类型 说明 3.1 guid string 每个配置用户登录后获得唯一的Guid标识
  • 报文样例 消息头 Content-Type:application/json; charset=UTF-8 请求参数 { "agentId": 101, "password": "******" } 响应参数 { "result": { "guid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1" }, "message": "success", "retcode": "0" }
  • 请求说明 消息头 表1 消息头参数说明 序号 名称 参数类型 是否必选 说明 1 Content-Type string True 消息主体编码方式,缺省值:application/json; charset=UTF-8 消息体 表2 消息体参数说明 序号 名称 参数类型 是否必选 说明 1 agentId number True 1.配置管理员登录时为座席工号。 取值的类型为整数,取值范围为1~59999。 2.VDN账号登录时为(VDN编号 + 100000)组成的数字 2 password string True 1.配置管理员登录时为工号对应的密码 2.VDN账号登录时为VDN对接密码
  • 响应说明 参数名称 数据类型 参数位置 必选/可选 描述 errorCode int body True 错误码 0:成功 非0表示失败 或可通过状态码为200判断为成功 errorMsg String body False 错误描述 authToken String body True 认证token expireTime int body False 令牌有效期,单位是秒数,默认 3600 秒; 错误码非0时,无返回。
  • 报文样例 请求消息体 { "appKey": "tenant001", "appSecret": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } 响应消息体 { "errorCode" : 0, // int, 错误码,无错时为0 "errorMsg" : "", // String, 出错信息,无错时为空 "authToken": "2************************", "expireTime" : 3600}