| 接口地址 | https://api.istero.com/resource/surname/rank |
|---|---|
| 请求方式 | HTTP POST GET |
| 返回格式 | application/json |
| 请求头部 | 必填 | 值 | 说明 | 示例 |
|---|---|---|---|---|
| Authorization | 可选 | TOKEN | 用户中心获取到的TOKEN，格式：Bearer <token> | Bearer 89defae676abd3e3a42b41df17c40096 |
| 参数 | 类型 | 必填 | 默认 | 描述 | 示例 |
|---|---|---|---|---|---|
| token | string | 可选 | 无 | 如传入Authorization，此参数可以忽略 | 89defae676abd3e3a42b41df17c40096 |
| surname | string | 是 | 无 | 姓氏 | 李 |
| 名称 | 描述 | |
|---|---|---|
| code | 响应码 | |
| data | surname | 姓氏 |
| isTraditional | 是否为百家姓 | |
| rank | 排名 | |
| type | 类型 | |
| description | 描述 | |
| message | 错误信息 | |
| elapsedTime | 响应耗时（ms） |
| 代码 | 描述 |
|---|---|
| 200 | 数据返回成功 |
| 202 | 余额不足，仅付费接口会出现此状态码 |
| 302 | 接口维护/停止服务 |
| 400 | 请求失败，“message”显示错误信息 |
| 403 | TOKEN鉴权失败 |
| 404 | 接口不存在 |
| 429 | 超出会籍QPS限制 |
| 500 | 接口服务器错误 |
| 502 | 账号被封锁/冻结 |
| 接口状态 | 正常 |
|---|---|
| 最后更新时间 | 2025-03-02 13:34:34 |
| 接口反馈 |
|
| 客服QQ | 97529013 |
|---|---|
| 客服邮箱 | service@istero.com |
| 企业官网 | https://www.istero.com |