2.2 KiB
2.2 KiB
API认证与鉴权
Cookie方式
cookie中的值在访问登录接口成功登录时，用set-cookie写入
在访问api时为Cookie头的数据
Token有效期为1月，更改密码或过期失效
| cookie项 | 含义 | 备注 |
|---|---|---|
| DedeUserID | 当前用户UID | |
| DedeUserID__ckMd5 | 用户UID md5校验值 | |
| SESSDATA | 登录Token | 用于用户识别与鉴权 作用同 access_key |
| bili_jct | CSRF Token | 用于操作性接口 |
APP方式
| 参数 | 含义 | 备注 |
|---|---|---|
| appkey | app密钥 | |
| sign | app签名 | |
| access_key | app登录Token | |
| refresh_token | app刷新登录Token | 仅在刷新时使用 |
接口鉴权：
使用appkey作为api的必要参数，并使用除sign外所有参数的url字串后连接相对应的盐值进行md5校验（32位小写），把计算结果作为sign的值，与前面参数一同发送
appkey与sign盐值一一对应
已知的appkey与签名：
| appkey | sign盐值 |
|---|---|
| 1d8b6e7d45233436 | 560c52ccd288fed045859ed18bffd973 |
| bb3101000e232e27 | 36efcfed79309338ced0380abd824ac1 |
| 07da50c9a0bf829f | 75d35aa5c06fb46e40059a6a5bf671a6 |
| 4409e2ce8ffd12b8 | 59b43e04ad6965f34319062b478f83dd |
| 37207f2beaebf8d7 | e988e794d4d4b6dd43bc0e89d6e90c43 |
例如：
参数的url为appkey=1d8b6e7d45233436&test=123->连接盐值后为appkey=1d8b6e7d45233436&test=123560c52ccd288fed045859ed18bffd973->进行md5 32bit校验，结果为8a3fdd74911862810f5c78f65afcce5d->最终参数为appkey=1d8b6e7d45233436&test=123&sign=8a3fdd74911862810f5c78f65afcce5d
身份认证：
使用参数access_key进行身份验证，有效期为1月，作用同SESSDATA
可以使用refresh_token进行刷新