跳转到主要内容

获取认证(必看)

Zdir 3部分接口,比如上传、重命名、删除等操作需要获取认证Token后才能操作,部分公共API则无需认证,获取认证方法如下。

接口说明

  • 请求地址:/api/user/login
  • 请求方法:POST
  • 提交方式:multipart/form-data

请求参数

参数名称 示例值 类型 是否必须 说明
username xiaoz string(16) 用户名
password xiaoz.me string(16) 密码

请求成功响应

{
	"code": 200,
	"data": {
		"UserName": "xxx",
		"Cid": "JJjKWZ",
		"Token": "5de13ebfb0xxxxxx861fbe"
	},
	"msg": "success"
}
  • code:200代表成功,其它为失败
  • msg:消息内容
  • data.UserName:返回用户名
  • data.Cid:返回的ClientID,后续认证需要
  • data.Token:返回的Token值,后续认证需要

注意:Token认证有效期为7天,过期后请重新获取。

请求失败响应

{
	"code": -1000,
	"data": "",
	"msg": "用户名或密码错误!"
}

请求认证

需要认证的接口需要携带header头部,以下为公共头部参数:

参数名称 示例值 类型 是否必须 说明
X-Cid JJjKWZ string(6) CID,对应data.Cid
X-Token 5de13ebfb0xxxxxx861fbe string(32) Toekn,对应data.Token