请求认证
接口名称
WEB_RequestCertificateAPI
功能描述
调用该接口请求认证,校验用户名、密码。并返回CSRF Token。
应用场景
通过该接口将用户名、密码等发到服务器端校验。如果校验成功,则认证通过并返回CSRFToken,后续所有json数据请求都必须带上CSRF Token字段。反之,返回失败响应,认证不通过。通过HTTP API接口对终端的操作,前提是认证通过。
URL
https://ip/action.cgi?ActionID=WEB_RequestCertificateAPI
参数
参数 | 类型 | 取值范围 | 参数说明 |
|---|---|---|---|
user | string | 不为空 | 用户名 |
password | string | 不为空 | 密码 |
返回值
参数 | 类型 | 取值范围 | 参数说明 |
|---|---|---|---|
success | int | [0, 1] | 响应结果 0:失败 1:成功 |
data | Object | 可选 | 成功返回数据。详细参考表3。 例如:{"success":1,"data":"{\"acCSRFToken\":\"s9C1zjO5HLnSf9u4eKP9uKfn8Kb9T94j\"}"} |
error | Object | 可选 | 失败返回错误信息。详细参考表4。 例如:{"success":0,"error":"id":100666995,"code":33558532,"params":[]}} |
参数 | 类型 | 取值范围 | 参数说明 |
|---|---|---|---|
id | int | 32位整数 | 错误id,用于转换。 |
code | int | 32位整数 | 错误码,跟错误id对应,具体含义参考错误码。 |
param | Object | param 对象 | 失败响应的附带参数。 |

