whz/paopao

Fork 0

whz ec7096e663 [add] api docs

2024-05-17 10:55:30 +08:00

2.2 KiB

Raw Blame History

RESTFul API 文档

获得推荐用户

1 接口描述

本API允许通过用户账号模糊匹配获得推荐用户。

2 请求URL

/v1/suggest/users?k=

3 请求方式

GET

4 请求头

头字段	必填	数据类型	描述

5 Query参数

参数名称	必填	数据类型	约束条件	描述	示例	允许空值
k	否	字符串		查询条件	"wang"	是

6 请求示例

GET /v1/suggest/users?k=w

7 返回参数说明

参数名称	必填	数据类型	约束条件	描述
code	是	整型		错误码，200表示成功
msg	否	字符串	1-50字符	错误信息描述
data	否	json		具体业务数据

8 响应示例（成功）

 {
  "code": 0,
  "msg": "success",
  "data": {
    "suggest": [
      "wangji",
      "whj",
      "whjwhj",
      "whz",
      "wu123",
      "www"
    ]
  }
}

9 响应示例（错误）

{ "code": 10001, "message": "验证码无效" }

10 错误响应码参考

更多响应错误码及含义，请参阅API响应码表。

11 安全性与认证

此API要求调用方在Authorization头中携带经过Bearer认证的令牌。

12 测试环境

访问测试环境以进行接口调试： https://test.apiAddress.com

13 版本管理

本API通过URI路径进行版本控制。请在请求URL中包含/v1以使用当前版本。

14 更新记录

2024-04-22：发布文档初始版本。
2024-05-05：新增安全性说明和测试环境链接。

15 联系支持

如需帮助或对API有任何疑问，请通过电子邮件与我们联系：support@api.com。

16 反馈与建议

发现文档问题或有改进建议？请填写反馈表单与我们分享。

2.2 KiB Raw Blame History Unescape Escape