用途:通过 Altium 365 需求与系统门户(Requirements & Systems Portal)的 REST API 管理 PCB 相关需求与系统设计数据,适用于提及 Altium 365、Altium、PCB、EDA、需求等场景。
必要用法:所有请求需设置 ALTIUM365_TOKEN(个人用户令牌)与 ALTIUM365_WORKSPACE_URL(形如 https://acme.365.altium.com),采用 Bearer 认证;基础路径为 $ALTIUM365_WORKSPACE_URL/rest。令牌在 Altium 365 → Settings → User Tokens 生成,有效期三个月。
主要能力:连接性自检(GET /projects?limit=1,401 多为令牌过期或无权访问门户,404 多为工作区地址错误);列出与获取项目;列出、创建(POST)、更新(PATCH)、删除(DELETE)需求;列出与创建组件;创建需求到组件的追溯链接(POST /traces);列出验证测试并记录测试结果;以列表接口配合大 limit 导出需求 JSON,超过 1000 条时用返回的 cursor 与 next_cursor 分页。
排障:可用 zero doctor check-connector --env-name ALTIUM365_TOKEN 或 zero doctor check-connector --url $ALTIUM365_WORKSPACE_URL/rest/projects --method GET。
限制:仅覆盖需求与系统门户 REST API,Workspace、Manufacturing Portal、ConcordPro 等使用 OAuth 的界面不在范围内;主机为各团队专属子域,无全局 API 主机;ID 为 UUID 或不透明字符串,需原样保存;PATCH 用于部分更新,PUT 会以 null 覆盖省略字段;日期为带 Z 的 ISO 8601;追溯链接为单向(需求→组件、需求→测试),查询入向链接需用父资源的 /traces 子路径;令牌支持按项目 ACL 缩小权限范围。官方文档见 https://www.altium.com/documentation/altium-365/requirements-systems-portal/rest-python-api-documentation。