注册开发者会员
/api/v1/developer/register
POST
/api/v1/developer/register调用说明
开放会员注册入口。先调用 /developer/session 获取会话和 CSRF。用户名唯一,密码至少 6 位,邮箱或手机号至少提供一项。成功后自动登录会员账号,新的 CSRF 需重新获取。
路径与请求头参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-CSRF-Token | header | string | 是 | 先 GET /developer/session 获取,必须使用同一 Cookie 会话 |
JSON 请求体
使用 application/json 提交请求体。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| username | string | 是 | 会员账号 |
| password | string | 是 | 参见调用说明 |
| nickname | string | 按操作要求 | 参见调用说明 |
| string | 按操作要求 | 参见调用说明 | |
| mobile | string | 按操作要求 | 参见调用说明 |
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 | 权限未获批准 |
| 419 | CSRF 无效 |
| 422 | 参数错误 |