listUsers · GET /users

目录

列出用户

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（甲案）。

curl 
curl -sS -X DELETE 'https://api.example.com/api/v1/users/42' \
  -H 'X-Demo-Key: YOUR_KEY'
版本号 #1
由 壳壳虫 创建于 2026-11-01 01:59:56 UTC
由 壳壳虫 更新于 2026-11-01 01:59:57 UTC