----
==== 认证接口 ====
如果在配置文件中配置了非空的ServerSecureKey(即如果没有Bangwo8APIServer.conf或者Bangwo8APIServer.conf中ServerSecureKey为空,则无需调用此接口),那么在后续调用所有Bangwo8APIServer.exe提供的功能性URL的时候,都需要提供一个会话秘钥SessionKey。该会话秘钥调用下面的URL获取:\\
**请求地址:**
http://127.0.0.1:xxxx/apiGetSessionKey?SaltedServerSecureKey={SaltedServerSecureKey}
**请求方式:** GET\\
**参数说明:**
^ 参数 ^ 是否必须 ^ 说明 ^
| SaltedServerSecureKey | 是 | 该参数是将Bangwo8APIServer.conf中的ServerSecureKey进行MD5哈希之后的取值 |
**返回值说明:**\\
正常情况下,本接口会返回下述JSON数据包给开发者:
{
"errorcode" : 0,
"message" : “success”,
"SessionKey" : "xxxxxx",
"Expirs_in" : "7200",
}
^ JSON字段 ^ 说明 ^
| errorcode | 应答结果码,0标识成功(该字段在所有应答消息中都有) |
| message | 出错消息,可以用于获取进一步的出错原因(该字段在所有应答消息中都有) |
| SessionKey | 返回的会话秘钥 |
| Expires_in | 以秒为单位的会话秘钥的有效时间段,如果超时则需要重新获取。 |