接口概览
请求成功后返回统一 JSON 数据。只有解析成功时才扣除一次当日可用次数;请求失败、凭证错误或平台不支持不会扣次。
GET
https://api.260.ink/api.php请求参数必须进行 URL 编码,特别是待解析链接本身含有
? 或 & 时。鉴权与请求参数
接口使用用户 ID 与接口密钥进行鉴权。密钥请妥善保管,不要写入可被公开查看的前端代码。
| 参数 | 类型 | 说明 | 示例 |
|---|---|---|---|
clientId必填 | Integer | 用户 ID,在“API接口”页面获取。 | 202036980 |
clientSecretKey必填 | String | 接口密钥,必须与 clientId 匹配。 | 4d70...b06fe |
url必填 | String | 视频链接或包含链接的整段分享文案,系统自动提取 URL 并识别平台。 | https://v.douyin.com/xxxx/ |
尚未申请接口凭证,请前往 API接口 页面申请。
请求示例
下面示例均请求同一个接口,请根据使用环境选择。
curl --get 'https://api.260.ink/api.php' \
--data-urlencode 'clientId={clientId}' \
--data-urlencode 'clientSecretKey={clientSecretKey}' \
--data-urlencode 'url=https://v.douyin.com/xxxx/'
<?php
$params = http_build_query([
'clientId' => '{clientId}',
'clientSecretKey' => '{clientSecretKey}',
'url' => 'https://v.douyin.com/xxxx/',
]);
$json = file_get_contents('https://api.260.ink/api.php?' . $params);
$result = json_decode($json, true);
const params = new URLSearchParams({
clientId: '{clientId}',
clientSecretKey: '{clientSecretKey}',
url: 'https://v.douyin.com/xxxx/'
});
const response = await fetch('https://api.260.ink/api.php?' + params);
const result = await response.json();
成功响应
业务成功码为 200,媒体字段统一位于 data 对象。
{
"code": 200,
"msg": "解析成功",
"data": {
"video_url": "https://example.com/video.mp4",
"cover_url": "https://example.com/cover.jpg",
"title": "视频标题",
"content": "视频文案"
}
}data.video_url无水印视频播放或下载地址。
data.cover_url视频封面地址,部分平台可能为空。
data.title作品标题,部分平台可能为空。
data.content作品文案,部分平台可能为空。
业务状态码
请以响应 JSON 中的 code 判断业务结果,不要仅依赖 HTTP 状态码。
| Code | 含义 | 处理建议 |
|---|---|---|
| 200 | 解析成功 | 读取 data 中的媒体字段。 |
| 103 | 链接不正确 | 检查 url 参数或分享文案中是否包含有效 HTTP(S) 链接。 |
| 104 | 平台未配置或接口已停用 | 在后台启用对应平台接口。 |
| 106 | 用户已禁用 | 检查账户状态并联系管理员。 |
| 107 | 解析数据结构异常 | 检查后台远程返回字段映射。 |
| 108 | 凭证为空或错误 | 核对 clientId 与 clientSecretKey 是否匹配。 |
| 109 | 开放接口已关闭 | 联系管理员开启 API 功能。 |
| 110 | 当日次数不足 | 升级套餐或等待次日恢复次数。 |
| 113 | 接口服务异常 | 检查数据库、cURL、远程接口及服务器日志。 |
| 115 | 会员等级不足 | 升级至拥有 API 权限的会员套餐。 |
注意事项
媒体地址可能带有效期,请在解析成功后及时使用;不要长期缓存第三方临时视频地址。
接口密钥属于敏感凭证,建议仅在服务端调用。若密钥泄露,请联系管理员重新生成。
建议设置合理的连接与读取超时,并针对非 200 业务码保留错误日志。