必捷 HTTP API 集成对接指南：从鉴权到业务接口的完整流程

必捷API体系架构

必捷API分为两层架构：设备层API（运行在BJ62S/BJ66终端本机，提供投屏/会议控制接口）和管理平台API（运行在MNG8000，提供多设备集中管理接口）。两层API风格统一，均基于HTTP/HTTPS + JSON，遵循RESTful规范。

设备层API

运行在BJ62S/BJ66终端本机（默认监听 http://设备IP:8080），适用于单设备直接控制场景，例如企业自研会议助手集成、设备调试、自动化测试。鉴权采用 HTTP Basic Auth（用户名/密码为设备后台账号）。

管理平台API

运行在MNG8000统一管理平台（默认监听 https://平台IP:8443），适用于多设备集中管理场景，例如集团IT运维系统、BI平台对接、第三方运维监控集成。鉴权采用 OAuth 2.0 风格的 Bearer Token，需先调用 /api/v1/auth/token 获取 Token。

鉴权流程详解

两种API鉴权方式流程差异较大，下面分别展开。

设备层API – Basic Auth

Basic Auth 是 HTTP 协议内置的最基础鉴权方式，调用方需在请求头携带 Authorization: Basic base64(username:password) 即可发起请求，无需先获取 Token。优势是简单直接，缺点是每次请求都需携带完整凭据。

1. 在 BJ62S/BJ66 后台 → 系统设置 → API访问 中启用”API远程访问”
2. 设置 API 用户名（建议专用账号，与后台账号分离）与强密码
3. 客户端按 HTTP Basic Auth 规则构造请求头，发起业务请求
4. 设备返回 JSON 格式业务数据，状态码遵循 HTTP 标准（200/401/403/500）

管理平台API – Bearer Token

MNG8000 采用 OAuth 2.0 风格的 Token 鉴权，调用方先调用 Token 接口获取 Access Token，后续用 Authorization: Bearer {token} 头调用业务接口。Token 默认有效期 7200 秒，过期前需用 Refresh Token 刷新。

1. POST /api/v1/auth/token 携带 client_id + client_secret 获取 Access Token + Refresh Token
2. 业务接口请求头携带 Authorization: Bearer {access_token}
3. Token 即将过期时（建议过期前 5 分钟）调用 POST /api/v1/auth/refresh 刷新
4. Refresh Token 也过期则需重新走步骤 1

核心业务接口清单

必捷API按业务域划分为5大类，每类提供完整的CRUD接口。下面列出每个业务域的核心接口与典型用途。

完整接口字段定义与示例请参考必捷互联开放平台官方文档 /news/company/bjcast-sdk-compliance。

Python + Java 双语言示例

Python 示例：拉取设备列表

以下 Python 示例演示如何调用管理平台 API 拉取设备列表：

import requests

PLATFORM = "https://platform.bijienetworks.com:8443"
CLIENT_ID = "your_client_id"
CLIENT_SECRET = "your_client_secret"

# 1. 获取 Access Token
token_resp = requests.post(
    f"{PLATFORM}/api/v1/auth/token",
    json={"client_id": CLIENT_ID, "client_secret": CLIENT_SECRET},
    timeout=10,
)
token = token_resp.json()["access_token"]

# 2. 拉取设备列表
headers = {"Authorization": f"Bearer {token}"}
devices = requests.get(
    f"{PLATFORM}/api/v1/devices",
    headers=headers,
    params={"status": "online", "page": 1, "page_size": 50},
    timeout=10,
).json()

for d in devices["items"]:
    print(f"{d['id']} | {d['name']} | {d['ip']} | {d['status']}")

Java 示例：触发远程会议

以下 Java 示例演示如何调用设备层 API 触发远程会议：

import java.net.http.*;
import java.util.Base64;

String deviceIP = "192.168.1.100";
String username = "api_user";
String password = "your_password";

String auth = Base64.getEncoder().encodeToString(
    (username + ":" + password).getBytes()
);

HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
    .uri(URI.create("http://" + deviceIP + ":8080/api/v1/meeting/start"))
    .header("Authorization", "Basic " + auth)
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(
        "{\"meeting_id\":\"123456789\",\"platform\":\"tencent_rooms\"}"
    ))
    .build();

HttpResponse<String> resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println("Status: " + resp.statusCode());
System.out.println("Body: " + resp.body());

5 类典型集成场景

以上 5 类场景覆盖企业自研系统的 90% 集成需求，具体对接方案可联系必捷商务获取《必捷API集成白皮书》。

常见问题

参考资料

1. BJCast SDK 合规使用说明 – 必捷互联开放平台
2. MNG8000 统一管理平台产品页
3. 必捷无线投屏SDK开发套件
4. BJ62S 多媒体协作系统
5. BJ66 标准版产品页