快速开始

使用开放平台控制台中的 API Key，完成你的第一个 Pipispy API 请求。

1. 获取 API Key

打开控制台，登录或注册账号。确认套餐和剩余数据额度，然后复制 API Key。

请在服务端保管密钥，不要将其写入公开仓库、浏览器代码或移动端应用。

2. 选择接口

可以先使用 Adspy 广告列表接口，通过筛选条件和分页参数获取广告数据。

• 请求方法：POST
• 请求地址：https://www.pipispy.com/open-api/v1/data
• 接口路径：/v3/api/open/adspy/list
• 内容类型：application/json

请求体包含 key、uri 和 params 三个字段。首次请求可以设置 current_page: 1、page_size: 10。成功获取数据会按接口说明消耗额度。

3. 处理返回结果

同时检查 HTTP 状态码与响应体中的 code、message。对于此接口，响应体中的 code: 200 表示成功。按照接口响应字段说明处理 data 内容。

HTTP 成功不一定代表业务操作成功，请在应用中处理参数、鉴权和额度等错误。

4. 接入业务流程

按照各接口说明配置分页与筛选条件。不同接口的必填参数和网关可能不同，例如广告监控使用 /open-api/v1/monitor/data，图片上传可使用 multipart 请求。

接入前请阅读鉴权与请求及用量与错误处理。下方示例在服务端运行；Python 需要安装 requests，JavaScript 需要支持内置 fetch 的 Node.js。