作者：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日

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