使用联合搜索集成多个搜索引擎 › 使用 REST 调用 CAFedSearch Servlet

使用 REST 调用 CAFedSearch Servlet

CAFedSearch servlet 提供了一个 RESTful 接口，自定义搜索客户端、程序和用户界面 (UI) 可以通过该接口发送搜索请求。

此 RESTful 接口仅接受遵循 OpenSearch 规范的 HTTP Collection GET 请求。它支持 JSON 和 XML 响应。每个请求都必须包含 Service Desk BOPSID 令牌，该令牌可从 CA SDM RESTful 或 SOAP Web 服务获取。

遵循这些步骤:

1. 使用 CA SDM RESTful Web 服务获取 BOPSID 令牌
2. 通过随登录凭据发送对 rest_access 资源的 HTTP POST 请求，可获取 REST 快捷键。

   也可以通过发送对 bopsid 资源的 HTTP POST 请求，使用 REST 快捷键获取 BOPSID 令牌。

3. 有关向 CA SDM RESTful Web 服务发送请求的详细信息，请参阅以下 CA SDM 目录中的示例文件：

   NX_ROOT\samples\sdk\rest\java
   

4. 要使用联合搜索 API 进行搜索，请发送有关搜索资源的 HTTP GET 请求，并通过 CA SDMURL 传递搜索标准和 BOPSID 令牌。

   GET 
   

   http://<sdmhostname>:<FS_TOMCAT_PORT>/cafedsearch/sdm/search?q=<searchTerms>&source=<adapterName>&BOPSID=<bopsidToken>&userid=<userId>
   

   searchTerms

   指定以空格分隔的关键字列表。必须是 URL 编码的。

   adapterName

   指定搜索引擎名称，该名称必须与使用适配器配置实用工具时在“搜索源”记录的“代码”字段中指定的名称一样。

   支持的其他参数如下所示：

   index

   指定期望在搜索结果中显示的第一个索引，必须是大于或等于 1 的整数。

   page

   指定期望在搜索结果中显示的第一个页面，必须是大于或等于 1 的整数。

   size

   指定期望在搜索客户端的每页上显示的结果数。

   type

   有效值包括 JSON 或 XML。