豌豆荚搜索

接口说明

用于在豌豆荚中检索应用信息，可获取应用包名、AppID 以及历史版本下载链接。适合需要查询应用基础信息或下载指定版本安装包的使用者。接口免费开放，无需密钥。

调用地址

https://api.styyds.qzz.io/apis/wdj

请求方式

本接口使用 GET 方式发起请求，请求参数以查询字符串形式附加在调用地址之后。

鉴权说明

本接口无需密钥，可直接调用。

请求参数

参数取值说明

• action：search 表示搜索应用，versions 表示获取历史版本，download 表示获取下载链接。
• keyword：仅在 action=search 时必填。
• app_id：在 action=versions 与 action=download 时必填，取值来源于 action=search 的返回结果。
• vcode：仅在 action=download 时必填，取值来源于历史版本结果中的版本号。

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "keyword": "QQ",
    "total": 2,
    "list": [
      {
        "app_id": "10086",
        "name": "QQ",
        "package_name": "com.tencent.mobileqq",
        "version_name": "8.9.63",
        "version_code": "10000",
        "icon": "https://example.com/icon/qq.png",
        "download_url": "https://example.com/download/qq.apk"
      },
      {
        "app_id": "10087",
        "name": "QQ轻聊版",
        "package_name": "com.tencent.qqlite",
        "version_name": "3.7.1",
        "version_code": "3021",
        "icon": "https://example.com/icon/qqlite.png",
        "download_url": "https://example.com/download/qqlite.apk"
      }
    ]
  }
}

响应字段说明

说明：当 action 为 versions 时，data.list 返回该应用的历史版本列表，字段结构与上表一致；当 action 为 download 时，data 返回对应版本的下载链接信息。

错误响应示例

当请求未能正常完成时，接口返回统一的 JSON 结构，其中 code 为业务状态标识，msg 为可读的提示信息，errcode 为具体业务错误码。调用方可依据 errcode 做精确的分支处理。

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

{
  "code": 0,
  "msg": "请求过于频繁（QPM 限制）",
  "errcode": 11005
}

{
  "code": 0,
  "msg": "接口不存在",
  "errcode": 11013
}

业务错误码说明

说明：本接口为免费接口，无需密钥即可调用，因此与密钥、积分相关的错误码通常不会在本接口触发；但为便于统一处理，仍按上表返回。涉及转发类能力时，11013 至 11016 以及 11017 均可能出现，调用方应对这些错误码做兼容处理。

调用示例

终端 curl（bash）

搜索应用，按软件名称查询并获取包名与 AppID：

curl "https://api.styyds.qzz.io/apis/wdj?action=search&keyword=QQ"

根据搜索返回的 AppID 查询历史版本：

curl "https://api.styyds.qzz.io/apis/wdj?action=versions&app_id=10086"

根据 AppID 与版本号获取下载链接：

curl "https://api.styyds.qzz.io/apis/wdj?action=download&app_id=10086&vcode=10000"

PHP

// PHP 示例：搜索豌豆荚应用
$url = "https://api.styyds.qzz.io/apis/wdj?action=search&keyword=QQ";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

$response = curl_exec($ch);
if ($response === false) {
    echo "请求失败: " . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);

注意事项

• 本接口无需密钥，调用地址固定为 https://api.styyds.qzz.io/apis/wdj，请勿将其改写成其他域名或路径。
• 请求方式仅支持 GET，参数需以查询字符串形式拼接在地址后，请确保参数值经过 URL 编码，避免中文关键词（如「QQ」以外的中文应用名）因未编码而请求失败。
• action 为必填参数，取值需为 search、versions、download 三者之一，传入其他值将无法得到预期结果。
• 三个 action 的参数依赖关系不同：search 依赖 keyword；versions 与 download 依赖 app_id；download 还需额外提供 vcode。请按对应场景补齐参数，缺参时接口不会返回有效数据。
• app_id 与 vcode 均来自上一环节的返回结果，请先调用 search 拿到 app_id，再调用 versions 拿到 vcode，不要自行猜测或复用其他应用的标识。
• 接口返回的下载链接通常具有时效性，建议在需要下载时实时获取，不要长期缓存后直接使用，以免链接失效。
• 虽然本接口免费且无需鉴权，仍请控制请求频率，避免短时间内高频轮询导致被限流或暂时不可用；批量场景建议加入适当间隔。
• 请始终通过 HTTPS 访问，不要在客户端硬编码或传播任何与本站相关的敏感配置信息。
• 返回内容以实际请求结果为准，字段结构可能随数据源调整而变化，接入方应对缺失字段做容错处理，不要强依赖固定字段顺序。