接口
关联路由
筛选参数
page、limit、q、role、status、city
字段
| 字段 | 类型 | 说明 |
|---|---|---|
id | number | 用户 ID |
name | string | 姓名 |
email | string | 邮箱 |
city | string | 城市 |
role | string | 角色,如 admin / member |
status | string | 状态,如 active / inactive |
created_at | string | ISO 时间 |
说明
- 写操作只返回模拟结果,不会保存;GET 响应缓存 60 秒。
常见错误
- 页码越界不会返回 404page=99 仍然返回 200,data 是空数组,meta.total 还是 8。列表为空要自己渲染空状态。
- limit 最大 50传 100 会按 50 处理,不会报错。
- GET 有 60 秒缓存响应头是 Cache-Control: public, max-age=60。调试时如果参数改了没生效,先确认不是缓存。
- 写操作不会保存POST 返回 201 和一个新 id,但列表里不会多出这条,刷新就恢复原样。
请求示例
curl "https://www.temp-api.com/mock/users?limit=3"
{
"code": 200,
"message": "ok",
"data": [
{ "id": 1, "name": "张伟", "role": "admin", "status": "active" }
],
"meta": { "page": 1, "limit": 3, "total": 8, "total_pages": 3 }
}