1. 接口清单

Token 管理接口是操作 Pandora 2.0 非常敏感的接口，通过接口形式操作API风险很高，尽量确保可信网络下，或者在界面操作。以下是搜索接口的清单：

1. 创建Token 接口：POST /api/v1/auth/tokens
2. 查询Token接口：GET /api/v1/auth/tokens
3. 启用Token 接口：PUT /api/v1/auth/tokens/{id}/status
4. 禁用Token 接口：PUT /api/v1/auth/tokens/{id}/status
5. 删除Token 接口：DELETE /api/v1/auth/tokens/{id}/

注意：搜索接口的请求格式是json格式，所以请求Header中必须添加 'Content-Type: application/json'

2. 接口描述

准备工作，先参考文档准备工作中所指导步骤，创建一个可用的Token，对接下来的其他Token进行操作。

2.1 创建Token 接口

请求路径：/api/v1/auth/tokens

请求方法：POST

请求体示例：

{
    "username":"pandora@qiniu.com",
    "audience":"default",
    "notBefore":1584344002522,
    "expireTime":1584430402522
}

请求体字段解释：

响应体示例：

{
  "id": "<TokenId>",
  "token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

响应体字段释义：

2.2 查询Token接口：

请求路径：GET /api/v1/auth/tokens?pageNo=<pageNo>&pageSize=<pageSize>&sort=<sort>&order=<order>&prefix=<prefix>

请求方法：GET

URL参数解释：

响应体示例：

{
    "total":2,
    "pageNo":1,
    "pageSize":2,
    "tokens":[
        {
            "id":"09e456c0-9b86-468c-b31d-3e963d3c024e",
            "username":"pandora@qiniu.com",
            "audience":"default",
            "notBefore":1575527903578,
            "expireTime":1575533907928,
            "issuedAt":1575527909225,
            "issuer":"pandora@qiniu.com",
            "status":"enabled",
            "lastAccessIP":"100.100.32.114",
            "lastAccessTime":1575528203896
        },
        {
            "id":"12a20dff-9182-4b51-afa7-d1a16a8ff33d",
            "username":"pandora@qiniu.com",
            "audience":"default",
            "notBefore":1576483954865,
            "expireTime":1576484435486,
            "issuedAt":1576483837431,
            "issuer":"pandora@qiniu.com",
            "status":"enabled",
            "lastAccessIP":null,
            "lastAccessTime":-1
        }
    ]
}

响应体字段示例：

2.3 启用、禁用 Token

请求路径：/api/v1/auth/tokens/{id}/status

注意：

1. <id> 为Token 的唯一标识

请求方法：PUT

请求体示例：

{
    "status":"enabled"
}

请求体释义：

2.4 删除 token

请求路径：/api/v1/auth/tokens/{id}/

注意：<id> 为Token 唯一标识

请求方法：DELETE

响应码200为删除成功

注意：建议定期更新Token，并关注Token的使用情况，避免Token泄露造成严重的数据风险。