{{ docItem.name }}
{{ listItem.name }}
{{ listItem.name }}
{{ item.name }}
{{ item }}
>
接口描述
获取鉴权参数（推荐使用 v4 版本）
- 请求正式域名：https://v3.aes.ssapi.cn/
- 请求测试域名：https://trial.aes.ssapi.cn/
- 支持协议：http、https
- 请求方式：POST 表单提交
- API：
- /api/v3/authorize （v3版本后续不再维护）
- /api/v4/authorize
测评请求参数
参数说明：
| 字段 | 类型 | 可选 | 说明 |
|---|---|---|---|
| app_id | string | 必选 | 授权商户的 app_id |
| user_id | string | 必选 | 商户自身的user_id，用于warrant_id区分不同用户 |
| timestamp | string | 必选 | 当前时间戳，单位：秒 |
| user_client_ip | string | 必选 | 客户端ip |
| request_sign | string | 必选 | 参数签名,签名生成需要用到这几个参数 app_id、timestamp、user_id、user_client_ip、app_secret，具体规则查看[评测流程]() |
参数示例
测评参数示例如下：
app_id:a111
user_id:w9egtDf3PMAOaxZVGSlQUip12no6WCvu
timestamp:1603885321
user_client_ip:111.111.111.111
request_sign:1db84d64f67e9a5d6356b82eb72bcfca测评返回结果
返回结果说明
| 键 | 类型 | 说明 |
|---|---|---|
| errId | int | 错误码 |
| message | string | 简要返回信息 |
| ret_time | string | 返回结果的时间 |
| request | object | 请求参数 |
| - appid | string | appid |
| - user_id | string | 用户id |
| - timestamp | string | 时间戳，单位秒，共10位数字 |
| - user_client_ip | string | 客户端ip |
| - request_sign | string | 请求签名 |
| response | object | 返回结果 |
| - code | int | 引擎内部错误码 |
| - message | string | 引擎内部返回简要信息 |
| - data | object | |
| -- warrant_id | string | 鉴权参数 |
| -- expire_at | int | 鉴权参数过期时间，有效期是7200秒 |
结果示例
测评结果示例如下：
{
"errId": 0,
"message": "success",
"ret_time": "2019-08-28 14:13:29.054",
"request": {
"appid": "a111",
"user_id": "w9egtDf3PMAOaxZVGSlQUip12no6WCvu",
"timestamp": "1603885321",
"user_client_ip": "111.111.111.111",
"request_sign": "1db84d64f67e9a5d6356b82eb72bcfca"
},
"response": {
"code": 0,
"message": "success",
"data": {
"warrant_id": "5d5111761e52913dd7b80e4c1f019",
"expire_at": 1565593974
}
}
}错误码
错误码参考：作文批改错误码
