🎬 即刻短剧API

专业的短剧内容管理接口平台 - API接口文档

📋 快速导航

🏠 基础信息

服务地址

基础URL: https://api.uuuka.com

API版本: v2.1.0

数据格式: JSON

字符编码: UTF-8

🌟 支持的内容类型

  • post - 短剧：热门短剧、微剧、网剧内容
  • dongman - 动漫：国产动漫、日漫、欧美动画
  • movie - 电影：院线电影、网络电影资源
  • tv - 电视剧：热播剧集、经典电视剧
  • xuexi - 学习资源：教育视频、技能培训内容

🔐 认证说明

访问限制

当前API采用IP限流机制，每个IP每分钟最多请求100次。

如需更高频率访问，请联系技术支持获取API密钥。

⚠️ 安全提醒

请勿在搜索关键词中包含特殊字符：< > " ' & ; ( ) { } [ ]

关键词长度不能超过100个字符。

📺 内容管理接口

获取所有内容

GET /api/contents
GET /api/contents?page=1&limit=20

请求参数

参数名 类型 必填 默认值 说明
page int 否 1 页码，范围：1-1000
limit int 否 20 每页数量，范围：1-100

响应示例

{ "success": true, "message": "获取成功", "data": { "items": [ { "id": 1, "title": "霸道总裁的小甜妻", "description": "现代都市甜宠短剧", "content_type": "post", "image_url": "https://example.com/image1.jpg", "created_at": "2024-01-01T00:00:00" } ], "total": 1000, "page": 1, "limit": 20, "total_pages": 50 } }

按类型获取内容

GET /api/contents/{content_type}
GET /api/contents/post?page=1&limit=20&keyword=霸道总裁

路径参数

参数名 类型 必填 说明
content_type string 是 内容类型：post/dongman/movie/tv/xuexi

查询参数

参数名 类型 必填 默认值 说明
page int 否 1 页码，范围：1-1000
limit int 否 20 每页数量，范围：1-100
keyword string 否 - 搜索关键词，支持模糊搜索

响应示例

{ "success": true, "message": "获取成功", "data": { "items": [ { "id": 1, "title": "霸道总裁的小甜妻", "description": "现代都市甜宠短剧", "content_type": "post", "image_url": "https://example.com/image1.jpg", "created_at": "2024-01-01T00:00:00" } ], "total": 50, "page": 1, "limit": 20, "total_pages": 3, "content_type": "post", "keyword": "霸道总裁" } }

获取支持的内容类型

GET /api/types
GET /api/types

响应示例

{ "success": true, "message": "获取成功", "data": { "supported_types": { "post": { "name": "短剧", "description": "热门短剧、微剧、网剧内容" }, "dongman": { "name": "动漫", "description": "国产动漫、日漫、欧美动画" }, "movie": { "name": "电影", "description": "院线电影、网络电影资源" }, "tv": { "name": "电视剧", "description": "热播剧集、经典电视剧" }, "xuexi": { "name": "学习资源", "description": "教育视频、技能培训内容" } }, "total_types": 5 } }

🔍 搜索接口

搜索内容

GET /api/search
GET /api/search?keyword=霸道总裁&content_type=post&page=1&limit=20

请求参数

参数名 类型 必填 默认值 说明
keyword string 是 - 搜索关键词，长度：1-100字符
content_type string 否 - 内容类型过滤
page int 否 1 页码，范围：1-1000
limit int 否 20 每页数量，范围：1-100

响应示例

{ "success": true, "message": "搜索成功", "data": { "items": [ { "id": 1, "title": "霸道总裁的小甜妻", "description": "现代都市甜宠短剧", "content_type": "post", "image_url": "https://example.com/image1.jpg", "created_at": "2024-01-01T00:00:00" } ], "total": 25, "page": 1, "limit": 20, "total_pages": 2, "keyword": "霸道总裁", "content_type": "post" } }

🔧 系统接口

系统状态

GET /api/status
GET /api/status

响应示例

{ "success": true, "message": "API服务正常运行", "data": { "service": "即刻短剧API", "version": "2.1.0", "status": "running", "environment": "production", "features": [ "短剧内容管理", "智能搜索引擎", "安全防护系统", "实时数据同步", "移动端优化" ] } }

健康检查

GET /api/health
GET /api/health

响应示例

{ "success": true, "message": "服务健康", "data": { "status": "healthy", "database": "connected", "timestamp": "2024-01-01T12:00:00Z" } }

❌ 错误码说明

状态码 错误码 说明 解决方案
200 - 请求成功 -
400 BAD_REQUEST 请求参数错误 检查请求参数格式和取值范围
404 RESOURCE_NOT_FOUND 请求的资源不存在 检查请求URL是否正确
429 RATE_LIMIT_EXCEEDED 请求频率超过限制 稍后重试或联系技术支持
500 INTERNAL_SERVER_ERROR 服务器内部错误 稍后重试或联系技术支持

错误响应格式

{ "success": false, "message": "错误描述", "error_code": "ERROR_CODE", "error": "详细错误信息", "suggestion": "解决建议" }

💡 使用示例

JavaScript/Ajax 示例

JavaScript/Ajax 
// 获取短剧列表
fetch('/api/contents/post?page=1&limit=10')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('获取成功:', data.data.items);
    } else {
      console.error('获取失败:', data.message);
    }
  })
  .catch(error => {
    console.error('请求错误:', error);
  });

// 搜索内容
fetch('/api/search?keyword=霸道总裁&content_type=post')
  .then(response => response.json())
  .then(data => {
    if (data.success) {
      console.log('搜索结果:', data.data.items);
    }
  });

Python 示例

Python 
import requests

# 基础URL
base_url = "https://api.uuuka.com"

# 获取短剧列表
response = requests.get(f"{base_url}/api/contents/post", params={
    'page': 1,
    'limit': 10,
    'keyword': '霸道总裁'
})

if response.status_code == 200:
    data = response.json()
    if data['success']:
        print("获取成功:", data['data']['items'])
    else:
        print("获取失败:", data['message'])
else:
    print("请求失败:", response.status_code)

# 搜索内容
search_response = requests.get(f"{base_url}/api/search", params={
    'keyword': '霸道总裁',
    'content_type': 'post',
    'page': 1,
    'limit': 20
})

if search_response.status_code == 200:
    search_data = search_response.json()
    print("搜索结果:", search_data['data']['items'])

cURL 示例

cURL 
# 获取所有内容
curl -X GET "https://api.uuuka.com/api/contents?page=1&limit=20"

# 获取指定类型内容
curl -X GET "https://api.uuuka.com/api/contents/post?page=1&limit=10&keyword=霸道总裁"

# 搜索内容
curl -X GET "https://api.uuuka.com/api/search?keyword=霸道总裁&content_type=post&page=1&limit=20"

# 获取系统状态
curl -X GET "https://api.uuuka.com/api/status"

# 健康检查
curl -X GET "https://api.uuuka.com/api/health"

💡 百度热搜短剧演员榜API | 接口地址：https://baidu.uuuka.com

接口文档 | 接口地址：https://baidu.uuuka.com | 演示地址：https://hot.uuuka.com

JavaScript/Ajax 
// 获取短剧列表

"description":"基于百度热搜榜数据的短剧演员排行榜API服务"

"authentication":"Bearer Token (IP绑定)"

"get_hot_dramas":"/api/drama-actors/hot-dramas"     热剧排行

"get_all_actors":"/api/drama-actors",               演员排行

"get_female_actors":"/api/drama-actors/female",     女性演员

"get_male_actors":"/api/drama-actors/male"          男性演员



// Token获取方式，扫描右小角图片公众号回复“ token ”
// Token获取方式，扫描右小角图片公众号回复“ token ”
// Token获取方式，扫描右小角图片公众号回复“ token ”
// Token获取方式，扫描右小角图片公众号回复“ token ”
// Token获取方式，扫描右小角图片公众号回复“ token ”

💡 夸克热搜榜数据API | 接口地址：https://baidu.uuuka.com

接口文档 | 接口地址：https://baidu.uuuka.com | 演示地址：https://hot.uuuka.com

JavaScript/Ajax 
// 获取短剧列表

"description":"基于夸克热搜榜数据的排行榜API服务"

"/api/quark/xxxxx/hot?start=1&hit=10 "          start起始页不能改变，hit根绝数据来决定可支持更大数值！

"authentication":"Bearer Token (IP绑定)"

"get_hot_dramas":"/api/quark/drama/hot"         短剧排行

"get_all_actors":"/api/quark/movie/hot"         电影排行

"get_female_actors":"/api/quark/tv/hot"         电视剧排行

"get_male_actors":"/api/quark/anime/hot"        动漫排行

"get_male_actors":"/api/quark/variety/hot"      综艺排行



// Token获取方式，扫描右小角图片公众号回复“ token ”
// Token获取方式，扫描右小角图片公众号回复“ token ”
// Token获取方式，扫描右小角图片公众号回复“ token ”
// Token获取方式，扫描右小角图片公众号回复“ token ”
// Token获取方式，扫描右小角图片公众号回复“ token ”

📞 技术支持

联系方式

技术支持邮箱: uchatrun@gmail.com

商务合作邮箱: uchatrun@gmail.com

API版本: v2.1.0

最后更新: 2025年6月

⚠️ 重要提醒

  • 请合理使用API，避免频繁请求导致服务器压力
  • 搜索关键词请避免使用特殊字符
  • 建议在生产环境中使用HTTPS协议
  • 如遇到问题，请及时联系技术支持

📱 微信公众号

微信公众号二维码

扫码关注获取最新动态