Android 友情链接 API 文档

作者：glzjin

最后更新时间：2017年10月17日

一、写作目的

为 Android 友情链接 提供云端服务接口。

二、基础参数

访问地址：https://recommend.wetolink.com/api/v2/

版本：v2

请求数据格式：json/xml/web form

返回数据格式：json

请求限制：单客户端每分钟60次

三、接口列表

0.ping测试

用途：用于检测服务器状态

请求类型：Any

地址：/ping

参数：无

返回参数：

• code
  • 100 服务器正常运行

1.获取APP推荐信息

用途：用于获取推荐的应用列表。

请求类型：GET

地址：/app_recommend/pull

参数：

• limit(可选)
  • 返回的条目数
• offset(可选)
  • 返回的条目起始位置
• package_name(可选)
  • 请求发起APP的包名，统计数据
• order_type(可选)
  • 排序依据，0或不填为随机顺序返回，1为按照访问排行返回（等同调用下文接口 2)
• language(可选)
  • 语言，暂时存着

返回参数：

• code
  • 100 查询成功
• data （以下为数组）
  • id
    • 记录id
  • appName
    • APP名
  • packageName
    • 包名
  • iconUrl
    • 图标链接
  • description
    • 描述
  • downloadUrl
    • 下载链接
  • downloadSize
    • 下载尺寸
  • createdTIme
    • 添加时间
  • updatedTime
    • 更新时间
  • openWithGooglePlay
    • 是否用 Google Play 打开

2.获取APP推荐排名信息

用途：用于获取推荐按查询次数排行的应用列表。

请求类型：GET

地址：/app_recommend/top/pull

参数：

• limit(可选)
  • 返回的条目数
• offset(可选)
  • 返回的条目起始位置
• package_name(可选)
  • 请求发起APP的包名，统计数据
• language(可选)
  • 语言，暂时存着

返回参数：

• code
  • 100 查询成功
• data （以下为数组）
  • id
    • 记录id
  • appName
    • APP名
  • packageName
    • 包名
  • iconUrl
    • 图标链接
  • description
    • 描述
  • downloadUrl
    • 下载链接
  • downloadSize
    • 下载尺寸
  • createdTIme
    • 添加时间
  • updatedTime
    • 更新时间
  • openWithGooglePlay
    • 是否用 Google Play 打开

四、更新日志

2017年10月10日

添加排名相关

2017年10月14日

修改时间相关字段，增加是否在 GP 打开字段。

2017年10月15日

v2 规范返回字段名

2017年10月17日

添加了排序和语言参数，同时默认排序改为随机。