列出用户

GET /api/v1/users

operationId: listUsers · 分组: Users · 鉴权: Header X-Demo-Key

演示用 GET：带 query 分页与搜索。响应来自文档示例（真源 OpenAPI）；本页不嵌入第三方调试器。侧栏/导航/深浅色一律沿用主题。

Query 参数

名称	位置	类型	必填	说明
`page`	query	integer	否	页码，默认 `1`，最小 `1`
`q`	query	string	否	搜索关键字
`token`	header	string	必填	演示必填微标（浅底方章甲案）

请求示例

curl（静态生成；本页无试调表单）

curl -sS 'https://api.example.com/api/v1/users?page=1&q=demo' \
  -H 'X-Demo-Key: YOUR_KEY'

fetch

fetch('https://api.example.com/api/v1/users?page=1&q=demo', {
  headers: { 'X-Demo-Key': 'YOUR_KEY' }
}).then(r => r.json())

响应

200 成功

{
  "args": { "page": "1", "q": "demo" },
  "url": "https://api.example.com/api/v1/users?page=1&q=demo"
}

400 参数错误

页码非法等。

创建用户

POST /api/v1/users

operationId: createUser · 分组: Users

POST 徽章 stub：跟阅读壳同安静度。

参数

名称	位置	类型	必填	说明
`name`	body	string	必填	用户名

curl

curl -sS -X POST 'https://api.example.com/api/v1/users' \
  -H 'Content-Type: application/json' \
  -H 'X-Demo-Key: YOUR_KEY' \
  -d '{"name":"demo"}'

删除用户

DELETE /api/v1/users/{id}

operationId: deleteUser · 分组: Users

DELETE 左边条 muted red（甲案）。