数据集合提供RESTful API,方便开发者接入我们的数据服务。
📋 基础信息
- Base URL:
https://51jh.net/wp-json/51jh/v1 - 认证方式:部分接口需要API Key
- 数据格式:JSON
- 请求方式:GET / POST
🔓 公开接口
获取统计数据
GET /stats/overview
返回网站统计概览(数据总数、城市数、行业数、贡献者数)
获取城市列表
GET /cities?level=1
参数:level – 城市级别(1=一线,2=新一线,3=二线…)
城市对比
GET /compare?city1=beijing&city2=shanghai
返回两城市各项对比数据
获取热门数据
GET /data/hot?limit=10
参数:limit – 返回数量,默认10
搜索数据
GET /data/search?q=北京租房
参数:q – 搜索关键词
🔒 需要认证的接口
提交数据
POST /submit
需要登录用户,提交新数据
获取贡献者排行榜
GET /leaderboard?limit=20
⚠️ 错误码
| 错误码 | 说明 |
|---|---|
| 400 | 请求参数错误 |
| 401 | 未授权,需要登录 |
| 404 | 资源不存在 |
| 429 | 请求过于频繁 |
| 500 | 服务器错误 |
🔑 申请API Key
如需使用需要认证的接口,或提高API调用频率限制,请联系我们申请API Key。
邮箱:api@51jh.net