📡 对外开放API对接完整文档

一、基础调用信息

API基础地址：https://pianzi.pw/api.php

鉴权Token（对接密钥）：AIRY_CLOUD_2026_API_8888

请求方式：GET / POST 均可，支持跨域调用

通用返回格式：标准JSON，code=200为成功，其他为错误

二、所有接口必填公共参数

参数名 说明 示例
token 对接密钥，固定值 AIRY_CLOUD_2026_API_8888
act 接口功能标识 search / bank_list / detail

接口1：关键词搜索（查询QQ/手机号/微信号）act=search

额外参数 必填 说明
keyword 是 要查询的号码、QQ、微信号
page 否 页码，默认1
limit 否 每页条数，默认20

调用示例链接：

https://pianzi.pw/api.php?token=AIRY_CLOUD_2026_API_8888&act=search&keyword=888888&page=1&limit=20

接口2：收录仓库全部数据分页 act=bank_list

额外参数 必填 说明
page 否 页码，默认1
limit 否 每页条数，默认20

调用示例链接：

https://pianzi.pw/api.php?token=AIRY_CLOUD_2026_API_8888&act=bank_list&page=1&limit=20

接口3：单条曝光详情页数据 act=detail

额外参数 必填 说明
id 是 数据ID（搜索接口返回的id字段）

调用示例链接：

https://pianzi.pw/api.php?token=AIRY_CLOUD_2026_API_8888&act=detail&id=123

三、成功返回JSON示例

{
    "code": 200,
    "msg": "success",
    "data": [
        {
            "id": 123,
            "data": "888888、222222",
            "msg": "网络刷单诈骗",
            "type": "QQ号",
            "time": "2026-07-02 14:20:10",
            "image": "https://pianzi.pw/assets/image/xxx.png"
        }
    ],
    "page": 1,
    "limit": 20,
    "total": 156,
    "total_page": 8
}

四、第三方网站前端JS调用示例

$.getJSON("https://pianzi.pw/api.php",{
    token:"AIRY_CLOUD_2026_API_8888",
    act:"search",
    keyword:"888888",
    page:1,
    limit:20
},function(res){
    if(res.code == 200){
        let html = "";
        res.data.forEach(item=>{
            html += `
号码：${item.data}，分类：${item.type}，曝光理由：${item.msg}
`;
        })
        $("#展示容器ID").html(html);
    }else{
        alert(res.msg);
    }
})

五、对接安全说明

  • Token密钥请勿泄露给无关人员，泄露可联系管理员更换密钥
  • 接口支持跨域，第三方网站可直接前端AJAX调用
  • 每页最大限制50条数据，请勿高并发恶意刷接口
  • 所有图片返回完整https地址，可直接加载展示

六、法律合规使用告知

  • 本平台API仅可用于反诈曝光、风险提醒、防骗科普合法场景，严禁任何违法违规用途
  • 禁止使用接口数据开展人肉搜索、恶意骚扰、敲诈勒索、批量倒卖公民信息等触犯法律的行为
  • 禁止将接口数据用于商业牟利、灰色引流、恶意竞争、抹黑他人等侵权违法场景
  • 对接方需自行承担调用API产生的全部法律责任，若违规使用，平台将永久封禁Token并保留追责权利
  • 如发现他人违规调用接口，可联系平台管理员曝光，共同维护合法反诈环境