登录 API

1.1 登录与刷新 API

Warning

为了避免滥用导致的服务可用性和钱包可用性下降，进而间接影响用户体验，我们强烈建议对登录数据进行检查。

登录

登录接口地址为:

POST /api/auth/login

客户端需要发送的数据为

{
    "identifier":"客户端识别码",
}

识别码长度为 19 个字符，共分为四段。格式为：XXXX-XXXX-XXXX-XXXX。

我们需要对客户端的识别码进行格式检查，确定是否有四段且总长度应该等于 19。

如果检查通过，服务端应返回 201 响应，响应格式如下。

{
    "status":201,
    "access_token":"<访问令牌>",
    "expire_in":172800
}

如果没有通过检查，服务端应返回 400 响应，格式如下。

{
    "status":400,
    "error":"Invalid Identifier"
}

如果客户端已被封禁，服务端应返回 403 响应，格式如下。

{
    "status":403,
    "error":"Identifier Blocked"
}