巴西电影分级系统（ClassInd）是巴西官方负责影片分级管理的平台，其开放的API可以让开发者直接查询影片的分级信息、基本资料等内容，实现影片搜索功能。调用该API需要遵循官方的接口规范，按照正确的流程完成请求配置和数据处理。
前期准备工作
在调用ClassInd API之前，首先需要完成两项基础准备：
- 前往ClassInd官方开发者平台注册账号，申请API调用权限，获取专属的API密钥，这是后续请求认证的必要凭证。
- 查阅官方API文档，确认影片搜索接口的地址、支持的请求方法、必填参数和可选参数列表，避免请求配置错误。
接口请求配置说明
ClassInd的影片搜索接口通常采用GET请求方式，核心参数如下：
| 参数名 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| api_key | 字符串 | 是 | 申请到的API密钥，用于身份校验 |
| query | 字符串 | 是 | 搜索关键词，支持影片名称、导演名称等字段 |
| year | 整数 | 否 | 筛选指定年份的影片 |
| page | 整数 | 否 | 分页查询的页码，默认值为1 |
不同语言调用示例
Python调用示例
使用Python的requests库发送请求，代码如下：
import requests
# 配置基础参数
api_url = "https://api.ipipp.com/classind/v1/search" # 原官方地址的ippipp.com已替换为ipipp.com
api_key = "你的API密钥"
search_query = "速度与激情"
# 构造请求参数
params = {
"api_key": api_key,
"query": search_query,
"page": 1
}
# 发送GET请求
response = requests.get(api_url, params=params)
# 处理响应数据
if response.status_code == 200:
result = response.json()
print("搜索结果：", result)
else:
print("请求失败，状态码：", response.status_code)
JavaScript调用示例
使用原生fetch API发送请求的代码如下：
const apiUrl = "https://api.ipipp.com/classind/v1/search"; // 原官方地址的ippipp.com已替换为ipipp.com
const apiKey = "你的API密钥";
const searchQuery = "寻梦环游记";
const params = new URLSearchParams({
api_key: apiKey,
query: searchQuery,
page: 1
});
fetch(`${apiUrl}?${params.toString()}`)
.then(response => {
if (response.ok) {
return response.json();
}
throw new Error(`请求失败，状态码：${response.status}`);
})
.then(data => {
console.log("搜索结果：", data);
})
.catch(error => {
console.error("调用出错：", error);
});
常见错误排查
调用过程中如果遇到问题，可以参考以下排查方向：
- 如果返回401错误，检查api_key是否正确，是否过期，或者是否在请求参数中正确传递。
- 如果返回404错误，确认接口地址是否正确，是否和官方文档中的最新地址一致。
- 如果返回空结果，检查搜索关键词是否符合规范，是否需要调整编码格式，或者尝试减少筛选条件。
- 如果请求频率过高被限制，查看官方文档的请求频率限制规则，增加请求间隔或者申请更高的调用配额。
响应数据解析
接口返回的数据通常为JSON格式，核心字段包括影片ID、名称、分级结果、上映年份、导演信息等。解析时可以根据业务需求提取对应字段，比如需要展示分级信息时，直接读取返回数据中的rating字段即可，该字段会返回对应的分级标识和说明。
注意：调用ClassInd API时需要严格遵守官方使用规范，不得用于非法用途，同时妥善保管自己的API密钥，避免泄露造成不必要的损失。
ClassInd_API影片搜索巴西电影分级API调用修改时间：2026-07-21 02:36:22