注册

本站开放API文档

Vicky

Android工程师

梦想着去周游世界，然后却只能偶尔看看窗外。
- Hi，你是第 2112 位来访者 -

点击排行

微信公众号

小猿圈-本站开放API文档

API仅限学习使用，切勿商用

首页

接口信息：

  • 访问路径： /api/article/articles
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
每页总数 limit String 否 * 每页总数，默认12
当前页数 page_number String 是 * 当前页数

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
firstPage boolean 是否是首页
lastPage boolean 是否是最后一页
pageNumber String 当前页面
pageSize String 单页文章数量
totalPage String 总页数
totalRow String 总行数
gmtModified Date 文章创建/更新时间
pv int 阅读次数
identify String 文章唯一标识符
intro String 文章简介
originUrl String 原文链接
isOriginal boolean 是否原创
url String 跳转链接

JSON 示例：

{
	"totalRow":"总行数",
	"gmtModified":"时间",
	"pageNumber":"当前页面",
	"lastPage":"文章标题",
	"identify":"文章唯一标识符",
	"totalPage":"总页数",
	"pv":"文章阅读次数",
	"pageSize":"单页文章数量",
	"url":"跳转链接，非原创请跳转originUrl。",
	"isOriginal":"是否原创",
	"firstPage":"是否是首页",
	"intro":"文章简介",
	"originUrl":"原文链接",
	"state":"ok"
}

杂粮圈

接口信息：

  • 访问路径： /api/article/coarse
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
每页总数 limit String 否 * 每页总数，默认12
当前页数 page_number String 是 * 当前页数

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
firstPage boolean 是否是首页
lastPage boolean 是否是最后一页
pageNumber String 当前页面
pageSize String 单页文章数量
totalPage String 总页数
totalRow String 总行数
gmtModified Date 文章创建/更新时间
pv int 阅读次数
identify String 文章唯一标识符
intro String 文章简介
originUrl String 原文链接
isOriginal boolean 是否原创
url String 跳转链接

JSON 示例：

{
	"totalRow":"总行数",
	"gmtModified":"时间",
	"pageNumber":"当前页面",
	"lastPage":"文章标题",
	"identify":"文章唯一标识符",
	"totalPage":"总页数",
	"pv":"文章阅读次数",
	"pageSize":"单页文章数量",
	"url":"跳转链接，非原创请跳转originUrl。",
	"isOriginal":"是否原创",
	"firstPage":"是否是首页",
	"intro":"文章简介",
	"originUrl":"原文链接",
	"state":"ok"
}

小猿圈

接口信息：

  • 访问路径： /api/article/technosphere
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
每页总数 limit String 否 * 每页总数，默认12
当前页数 page_number String 是 * 当前页数

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
firstPage boolean 是否是首页
lastPage boolean 是否是最后一页
pageNumber String 当前页面
pageSize String 单页文章数量
totalPage String 总页数
totalRow String 总行数
gmtModified Date 文章创建/更新时间
pv int 阅读次数
identify String 文章唯一标识符
intro String 文章简介
originUrl String 原文链接
isOriginal boolean 是否原创
url String 跳转链接

JSON 示例：

{
	"totalRow":"总行数",
	"gmtModified":"时间",
	"pageNumber":"当前页面",
	"lastPage":"文章标题",
	"identify":"文章唯一标识符",
	"totalPage":"总页数",
	"pv":"文章阅读次数",
	"pageSize":"单页文章数量",
	"url":"跳转链接，非原创请跳转originUrl。",
	"isOriginal":"是否原创",
	"firstPage":"是否是首页",
	"intro":"文章简介",
	"originUrl":"原文链接",
	"state":"ok"
}

公众号

接口信息：

  • 访问路径： /api/article/wpa
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
每页总数 limit String 否 * 每页总数，默认12
当前页数 page_number String 是 * 当前页数

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
firstPage boolean 是否是首页
lastPage boolean 是否是最后一页
pageNumber String 当前页面
pageSize String 单页文章数量
totalPage String 总页数
totalRow String 总行数
gmtModified Date 文章创建/更新时间
pv int 阅读次数
identify String 文章唯一标识符
intro String 文章简介
originUrl String 原文链接
isOriginal boolean 是否原创
url String 跳转链接

JSON 示例：

{
	"totalRow":"总行数",
	"gmtModified":"时间",
	"pageNumber":"当前页面",
	"lastPage":"文章标题",
	"identify":"文章唯一标识符",
	"totalPage":"总页数",
	"pv":"文章阅读次数",
	"pageSize":"单页文章数量",
	"url":"跳转链接，非原创请跳转originUrl。",
	"isOriginal":"是否原创",
	"firstPage":"是否是首页",
	"intro":"文章简介",
	"originUrl":"原文链接",
	"state":"ok"
}

用户登录

接口信息：

  • 访问路径： /api/login
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
用户名 ac String 是 * 用户名
密码 pwd String 是 * 密码

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
msg String 登录状态
access_token String access_token
expire_time String token过期时间
user_id String 用户id
info String 提示信息

JSON 示例：

{
	"msg":"登录成功",
	"access_token":"access_token",
	"user_id":"用户id",
	"expire_time":"token过期时间",
	"state":"ok",
	"info":"Hi, 欢迎访问小YUAN圈。"
}

退出登录

接口信息：

  • 访问路径： /api/logout
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
access_token access_token String 是 * access_token

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
msg String 登录状态
info String 提示信息

JSON 示例：

{
	"msg":"已退出登录",
	"state":"ok",
	"info":"Bye-bye."
}

导航

接口信息：

  • 访问路径： /api/nav
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 否 * token

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
id int ID
title String 标题
url String 跳转链接

JSON 示例：

{
	"state":"ok",
	"id":"ID",
	"title":"标题",
	"url":"跳转链接"
}

用户信息

接口信息：

  • 访问路径： /api/user/info
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 否 * token
用户ID，登录后返回的user_id user_id String 否 * 用户ID

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
user_id int 用户ID
name String 用户名
age String 年龄
sex String 性别
email String 邮箱
qq String qq
description String 简介
abposition String 职位

JSON 示例：

{
	"qq":"qq",
	"abposition":"职位",
	"user_id":"用户ID",
	"sex":"性别, true: 男; false: 女",
	"name":"用户名",
	"description":"简介",
	"state":"ok",
	"age":"年龄",
	"email":"邮箱"
}

用户信息

接口信息：

  • 访问路径： /api/user/modify
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
用户ID，登录后返回的user_id user_id String 是 * 用户ID
用户名 name String 是 * 用户名
年龄 age String 否 * 年龄
性别, true: 男; false: 女 sex String 否 * 性别
邮箱 email String 否 * 邮箱
qq qq String 否 * qq
简介 description String 否 * 简介
职位 abposition String 否 * 职位

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
msg int 提示信息

JSON 示例：

{
	"msg":"用户信息修改成功/失败",
	"state":"ok"
}

空气质量

接口信息：

  • 访问路径： /api/weather/aqi
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
城市编码 locationKey String 是 * 城市编码

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
aqi int 空气质量
aqiDesc String 空气质量说明
aqiText String 空气质量等级
co float 一氧化碳
expireTime long 过期时间
level int 等级
no2 int 二氧化氮
o3 int 臭氧
pm10 int PM10
pm25 int PM2.5
so2 int 二氧化硫

JSON 示例：

{
	"no2":"",
	"aqiDesc":"",
	"expireTime":"",
	"o3":"",
	"pm25":"",
	"level":"",
	"so2":"",
	"aqi":"",
	"pm10":"",
	"aqiText":"",
	"state":"ok",
	"co":""
}

实时天气

接口信息：

  • 访问路径： /api/weather/current
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
城市编码 locationKey String 是 * 城市编码

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
cloudCover int 云量
expireTime long 数据过期时间
humidity int 湿度
pressure int 气压
realFeel int 体感温度
temperature int 气温
uvIndex int 紫外线等级
uvText String 紫外线等级提示
visibility int 能见度
weatherDesc String 天气描述
weatherId int 天气id
weatherText String 天气说明
windDirText String 风向
windSpeed int 风速

JSON 示例：

{
	"weatherDesc":"",
	"uvText":"",
	"visibility":"",
	"cloudCover":"",
	"pressure":"",
	"weatherText":"",
	"realFeel":"",
	"weatherId":"",
	"expireTime":"",
	"temperature":"",
	"humidity":"",
	"state":"ok",
	"uvIndex":"",
	"windDirText":"",
	"windSpeed":""
}

未来5天天气

接口信息：

  • 访问路径： /api/weather/daily
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
城市编码 locationKey String 是 * 城市编码

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
aqiText long 空气质量
cloudCover int 云量
expireTime long 过期时间
humidity int 湿度
uvText String 紫外线强度
weatherId int 天气ID
weatherText String 天气
windDirText String 风向
windSpeed int 风速

JSON 示例：

{
	"weatherId":"",
	"expireTime":"",
	"uvText":"",
	"cloudCover":"",
	"aqiText":"",
	"humidity":"",
	"state":"ok",
	"windDirText":"",
	"windSpeed":"",
	"weatherText":""
}

天气数据

接口信息：

  • 访问路径： /api/weather/data
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
城市编码 locationKey String 是 * 城市编码

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
说明 String 参见其他单项天气数据说明

JSON 示例：

{
	"state":"ok",
	"说明":""
}

12小时天气

接口信息：

  • 访问路径： /api/weather/hourly
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
城市编码 locationKey String 是 * 城市编码

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
date long 日期
expireTime long 数据过期时间
rainProbability int 降雨概率
temperature int 气温
weatherId int 天气ID
windDirText String 风向
windSpeed int 风速

JSON 示例：

{
	"date":"",
	"weatherId":"",
	"expireTime":"",
	"temperature":"",
	"state":"ok",
	"windDirText":"",
	"windSpeed":"",
	"rainProbability":""
}

生活提示

接口信息：

  • 访问路径： /api/weather/liveTips
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
城市编码 locationKey String 是 * 城市编码

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
code int 排序
expireTime long 过期时间
name String 名称
status String 说明
tip String 提示

JSON 示例：

{
	"code":"",
	"expireTime":"",
	"name":"",
	"tip":"",
	"state":"ok",
	"status":""
}

搜索城市

接口信息：

  • 访问路径： /api/weather/search
  • 数据类型： application/x-www-form-urlencoded

请求参数：

参数 名称 数据类型 是否必须 提交方式 描述
token access_token String 是 * token
搜索内容 query String 是 * 搜索内容

数据响应：Ret

Ret

字段 数据类型 描述
state String 状态，成功 ok，失败 fail
administrativeArea boolean 省
cityCode boolean 城市编码
cityName String 城市名称
country String 国家
type String 类型

JSON 示例：

{
	"country":"",
	"cityName":"",
	"cityCode":"",
	"state":"ok",
	"administrativeArea":"",
	"type":""
}