API 对接文档

API代理服务为视频采集系统提供安全代理访问。购买套餐并绑定IP后，通过专属 key 即可调用接口。

验证流程

1 用户请求
2 验证 key
3 验证套餐
4 验证IP
代理转发
返回数据

接口地址

endpoint
GET/POST https://caiji.u55u.cn/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

bash 
                # act=1 无筛选
                curl "https://caiji.u55u.cn/api/api.php?act=1&key=YOUR_KEY"

                # act=2 按来源筛选
                curl "https://caiji.u55u.cn/api/api.php?act=2&key=YOUR_KEY&from=source_name"

Python

python 
                import requests

                key = "YOUR_KEY"
                url = "https://caiji.u55u.cn/api/api.php"

                params = {"act": 1, "key": key}
                resp = requests.get(url, params=params, timeout=30)
                data = resp.json()
                print(data)

PHP

php 
                $key = 'YOUR_KEY';
                $url = 'https://caiji.u55u.cn/api/api.php?act=1&key=' . urlencode($key);
                $response = file_get_contents($url);
                $data = json_decode($response, true);
                print_r($data);

JavaScript

javascript 
                const key = 'YOUR_KEY';
                const url = `https://caiji.u55u.cn/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，先删除旧的再添加。