跳到正文
SSaleSass开发者文档
管理后台
文档中心接口文档
接口文档

注册开发者会员

/api/v1/developer/register

POST/api/v1/developer/register

调用说明

开放会员注册入口。先调用 /developer/session 获取会话和 CSRF。用户名唯一,密码至少 6 位,邮箱或手机号至少提供一项。成功后自动登录会员账号,新的 CSRF 需重新获取。

路径与请求头参数

参数位置类型必填说明
X-CSRF-Tokenheaderstring是先 GET /developer/session 获取,必须使用同一 Cookie 会话

JSON 请求体

使用 application/json 提交请求体。

参数类型必填说明
usernamestring是会员账号
passwordstring是参见调用说明
nicknamestring按操作要求参见调用说明
emailstring按操作要求参见调用说明
mobilestring按操作要求参见调用说明

Axios 请求示例

会员管理请求使用开发者会话;写请求从开发者中心页面读取 CSRF 令牌。

javascript
// 同源浏览器保留 Cookie;服务端客户端需保存并发送会话 Cookie。
const session = await axios.get('/api/v1/developer/session');
const csrfToken = session.data.data.csrf_token;
axios.create({headers: {'X-CSRF-Token': csrfToken}}).post('/api/v1/developer/register', {
    "username": "developer01",
    "password": "ChangeMe123",
    "nickname": "开发者",
    "email": "developer@example.com"
});

响应结构示例

以下为结构示例,不是实时接口结果;列表和文档对象可能省略部分项目。

json
{
    "code": 0,
    "message": "操作成功",
    "data": {
        "id": 21,
        "username": "developer01"
    }
}

响应状态

HTTP 状态含义
200成功
401认证失败
403权限未获批准
419CSRF 无效
422参数错误
SaleSass 开发者文档 · 与项目内的接口契约同步