如何通过 API 正确调用巴西电影分级系统（ClassInd）网站进行影片搜索

本文详解如何绕过 400 错误，成功向巴西司法部 classind 门户的后端 api 发起带身份认证的 post 请求，完成影片标题搜索并结构化解析响应数据。

要成功调用 https://classindportal.mj.gov.br/api/solicitacao-classificacao-consultas/list 进行影片搜索，仅发送 {'tituloBr': 'shrek'} 是不够的——该接口受 OAuth 2.0 保护，必须携带有效的 Bearer Token。直接使用 requests.post(..., data=payload) 会因缺失认证头和错误的请求格式导致 400 Bad Request。

关键问题在于：
✅ Token 获取：需先向 Keycloak 认证服务申请访问令牌；
✅ 请求格式：目标 API 接收的是 application/json 格式的 JSON body（非 x-www-form-urlencoded），因此应使用 json= 参数而非 data=；
✅ 完整请求头：除 Authorization 外，还需模拟浏览器行为，包含 Origin、Referer、User-Agent 等必要头字段。

以下是可直接运行的完整 Python 示例（基于 requests）：

import requests

SEARCH_TERM = "shrek"

# Step 1: 获取访问令牌
token_url = "https://sso.mj.gov.br/auth/realms/PRD/protocol/openid-connect/token"
token_data = {
    "client_id": "classind-consultapublica-frontend",
    "client_secret": "4PmaBa8bBeVow40SKFNb7qNHzAxuLoqz",
    "grant_type": "client_credentials",
    "scope": "classind-backend",
}

# Step 2: 构建搜索请求头与载荷
movies_url = "https://classindportal.mj.gov.br/api/solicitacao-classificacao-consultas/list"
headers = {
    "Accept": "application/json, text/plain, */*",
    "Origin": "https://classindportal.mj.gov.br",
    "Referer": "https://classindportal.mj.gov.br/consulta-filmes",
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    "Connection": "keep-alive",
    "Sec-Fetch-Dest": "empty",
    "Sec-Fetch-Mode": "cors",
    "Sec-Fetch-Site": "same-origin",
}

json_payload = {
    "currentPage": 0,
    "pageSize": 10,
    "sortItem": None,
    "totalResults": None,
    "itens": None,
    "tituloBr": SEARCH_TERM,
    "tituloOr": "",
    "requerente": "",
    "produtor": "",
    "editora": "",
    "idModulo": 1,
}

# Step 3: 使用 Session 自动管理会话与 Token 注入
with requests.Session() as session:
    # 获取 token
    token_resp = session.post(token_url, data=token_data)
    token_resp.raise_for_status()
    access_token = token_resp.json()["access_token"]

    # 注入 Authorization 头
    headers["Authorization"] = f"Bearer {access_token}"

    # 发起搜索请求（注意：使用 json= 而非 data=）
    search_resp = session.post(movies_url, json=json_payload, headers=headers)
    search_resp.raise_for_status()

    result = search_resp.json()
    print("共返回", len(result.get("itens", [])), "条匹配结果")
    for item in result.get("itens", [])[:3]:
        print(f"ID: {item['id']}, 标题: {item['tituloBrasil']}, 分级: {item.get('classificacaoAtribuida', 'N/A')}")

⚠️ 注意事项： client_secret 属于前端公开凭证，虽可安全使用，但请勿在公开仓库中硬编码；生产环境建议通过环境变量加载。 currentPage 和 pageSize 支持分页，如需获取全部结果，请循环递增 currentPage 并合并 itens 列表。 若响应中 itens 为空，请检查 tituloBr 是否严格匹配（该字段区分大小写且可能截断空格）。 若频繁请求遭遇限流或 401 Unauthorized，说明 Token 已过期（通常有效期约 5 分钟），需重新获取。

进阶提示：可将结果快速转为 Pandas DataFrame 进行分析：

import pandas as pd
# ...（上述 session 代码块内，search_resp 成功后）
df = pd.DataFrame(result["itens"])
print(df[["id", "tituloBrasil", "classificacaoAtribuida"]].head())

至此，你已掌握调用 ClassInd 官方 API 的完整链路：认证 → 搜索 → 解析。该模式适用于所有受 Keycloak 保护的巴西政府开放 API，具备良好的复用性与工程扩展基础。

# python  # js  # 前端  # json  # go  # windows  # 编码  # 浏览器  # app  # access  # session  # 后端  # ai 

相关文章： 宠物网站制作html代码,有没有专门介绍宠物如何养的网站啊？  武汉网站制作费用多少,在武汉武昌，建面100平方左右的房子，想装暖气片，费用大概是多少啊？  广州网站制作公司哪家好一点,广州欧莱雅百库网络科技有限公司官网？  建站之星代理如何获取技术支持？  大同网页,大同瑞慈医院官网？  ,怎么在广州志愿者网站注册？  建站之星好吗？新手能否轻松上手建站？  如何通过西部数码建站助手快速创建专业网站？  如何制作算命网站,怎么注册算命网站？  制作网站的过程怎么写,用凡科建站如何制作自己的网站？  如何用VPS主机快速搭建个人网站？  大连网站设计制作招聘信息,大连投诉网站有哪些？  企业微网站怎么做,公司网站和公众号有什么区别？  制作公司内部网站有哪些,内网如何建网站？  深圳企业网站制作设计,在深圳如何网上全流程注册公司？  招商网站制作流程,网站招商广告语？  C#怎么创建控制台应用 C# Console App项目创建方法  如何通过VPS搭建网站快速盈利？  C#怎么使用委托和事件 C# delegate与event编程方法  制作销售网站教学视频,销售网站有哪些？  网站视频怎么制作,哪个网站可以免费收看好莱坞经典大片？  建站168自助建站系统：快速模板定制与SEO优化指南  专业网站制作企业网站,如何制作一个企业网站，建设网站的基本步骤有哪些？  建站之星安装模板失败：服务器环境不兼容？  佛山企业网站制作公司有哪些,沟通100网上服务官网？  *服务器网站为何频现安全漏洞？  如何快速搭建高效WAP手机网站？  如何在Windows 2008云服务器安全搭建网站？  如何在宝塔面板中修改默认建站目录？  建站之星在线版空间：自助建站+智能模板一键生成方案  高防服务器租用首荐平台，企业级优惠套餐快速部署  七夕网站制作视频,七夕大促活动怎么报名？  网站制作哪家好,cc、.co、.cm哪个域名更适合做网站？  如何规划企业建站流程的关键步骤？  如何在Golang中实现微服务服务拆分_Golang微服务拆分与接口管理方法  如何在建站之星绑定自定义域名？  如何快速辨别茅台真假？关键步骤解析  建站之星2.7模板：企业网站建设与h5定制设计专题  新网站制作渠道有哪些,跪求一个无线渠道比较强的小说网站，我要发表小说？  公司门户网站制作流程,华为官网怎么做？  如何通过老薛主机一键快速建站？  香港服务器租用费用高吗？如何避免常见误区？  电商网站制作多少钱一个,电子商务公司的网站制作费用计入什么科目？  详解jQuery停止动画——stop()方法的使用  建站主机数据库如何配置才能提升网站性能？  定制建站方案优化指南：企业官网开发与建站费用解析  视频网站app制作软件,有什么好的视频聊天网站或者软件？  高端企业智能建站程序：SEO优化与响应式模板定制开发  公司网站制作费用多少,为公司建立一个网站需要哪些费用？  如何在IIS中配置站点IP、端口及主机头？