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,先删除旧的再添加。