API文档

开发者接口文档

数据集合提供RESTful API,方便开发者接入我们的数据服务。

📋 基础信息

  • Base URLhttps://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