RTC Java APIs与REST客户端入门：如何在Mozilla中使用REST客户端

前置准备 #

• 先将Firefox浏览器升级到最新正式版，避免旧版出现API兼容性问题
• 可以直接使用Firefox内置的开发者工具-网络面板完成REST请求调试，无需额外安装扩展；如果需要更丰富的参数配置功能，也可以安装常用的REST客户端扩展，安装完成后在浏览器扩展栏点击对应图标即可启动。

基础操作步骤 #

1. 身份校验配置 #

RTC的REST接口默认需要身份认证，操作前先完成认证配置：

• 打开REST客户端面板后，在请求头（Headers）区域添加认证字段：Authorization: Basic <你的RTC账号密码Base64编码串>，或者选择客户端内置的Basic Auth选项，直接输入RTC的账号、密码，客户端会自动生成对应请求头
• 额外添加请求头Content-Type: application/json，适配绝大多数RTC REST接口的参数格式要求

2. 测试基础连通性 #

先调用RTC的根服务接口验证连接是否正常：

• 请求方法选择GET
• 请求地址填入你的RTC服务根地址，内网部署的RTC服务地址格式通常为https://<你的RTC服务域名>/ccm/
• 点击发送按钮，如果返回200状态码且响应体包含RTC服务基础信息，说明连通正常

3. 常用RTC操作请求示例 #

你可以按照以下示例尝试调用常用接口，后续再按需对接Java API：

• 查询工作项：使用GET方法，地址格式为https://<你的RTC服务域名>/ccm/oslc/workitems/<工作项ID>，发送后可获取对应工作项的全量元数据
• 新建工作项：使用POST方法，地址格式为https://<你的RTC服务域名>/ccm/oslc/workitems/creator，在请求体（Body）区域填入符合RTC规范的JSON参数，发送后即可完成创建

对接RTC Java API的注意事项 #

• 所有在REST客户端调试通过的请求参数、请求头配置，可以直接复用到Java API的请求构造逻辑中，降低调试成本
• 如果在Java代码中遇到权限报错，可以先在REST客户端中用相同参数调用接口，排查是参数问题还是账号权限问题，缩小问题范围

内容的提问来源于stack exchange，提问作者Namrata