API 对接文档
API代理服务为视频采集系统提供安全代理访问。购买套餐并绑定IP后,通过专属 key 即可调用接口。
验证流程
用户请求
→
验证 key
→
验证套餐
→
验证IP
→
代理转发
→
返回数据
接口地址
GET/POST https://caiji.u1r.cc/api/api.php
请求参数
公共参数(必填)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| act | string | 是 | 1 = 无筛选,2 = 按来源筛选 |
| key | string | 是 | 你的API密钥,在控制台可查看 |
act=2 时额外参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| from | string | 是 | 资源来源标识 |
除 act、key、from 外,所有参数会透传给上游API。
常见错误
| 错误信息 | 原因 | 解决方法 |
|---|---|---|
| 缺少必要参数: act | 未传 act 参数 | 加上 ?act=1 |
| 缺少必要参数: key | 未传 key 参数 | 加上 &key=你的密钥 |
| API密钥无效或账号已被禁用 | key 不存在或被禁用 | 检查控制台中的API密钥 |
| 当前账户无可用套餐 | 未购买或套餐已过期 | 购买或续费套餐 |
| IP未授权(当前IP: x.x.x.x) | 当前IP未加入授权列表 | 在控制台添加此IP |
调用示例
cURL
# act=1 无筛选
curl "https://caiji.u1r.cc/api/api.php?act=1&key=YOUR_KEY"
# act=2 按来源筛选
curl "https://caiji.u1r.cc/api/api.php?act=2&key=YOUR_KEY&from=source_name"
Python
import requests key = "YOUR_KEY" url = "https://caiji.u1r.cc/api/api.php" params = {"act": 1, "key": key} resp = requests.get(url, params=params, timeout=30) data = resp.json() print(data)
PHP
$key = 'YOUR_KEY'; $url = 'https://caiji.u1r.cc/api/api.php?act=1&key=' . urlencode($key); $response = file_get_contents($url); $data = json_decode($response, true); print_r($data);
JavaScript
const key = 'YOUR_KEY'; const url = `https://caiji.u1r.cc/api/api.php?act=1&key=${encodeURIComponent(key)}`; fetch(url) .then(res => res.json()) .then(data => console.log(data));
使用步骤
1
注册账号
获取API密钥
2
购买套餐
支付自动开通
3
绑定IP
控制台添加IP
4
调用接口
按示例请求
✓
获取数据
代理返回结果
注意事项
- • IP必须授权。只有绑定的IP地址才能通过验证,更换机器/IP后需重新绑定。
- • Key不能泄露。API密钥等同于账户凭证,请勿分享给他人。
- • 套餐到期后接口不可用。请及时续费,到期后需重新购买套餐。
- • 一个套餐对应一组IP。如需绑定新IP,先删除旧的再添加。