Wiki Search Results - Fetch Wiki Search Results

参考

服务:: Search

API 版本:: 7.1

为搜索请求提供一组结果。

POST https://almsearch.dev.azure.com/{organization}/{project}/_apis/search/wikisearchresults?api-version=7.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path		string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1”才能使用此版本的 API。

请求正文

名称	类型	说明
$orderBy	SortOption[]	用于对搜索结果进行排序的选项。如果设置为 null，则结果将按相关性进行排序。如果提供了多个排序选项，则结果按 OrderBy 中指定的顺序进行排序。
$skip	integer (int32)	要跳过的结果数。
$top	integer (int32)	要返回的结果数。
filters	object	要应用的筛选器。如果没有要应用的筛选器，则将其设置为 null。
includeFacets	boolean	用于选择结果中的分面的标志。默认行为为 false。
searchText	string	搜索文本。

响应

名称	类型	说明
200 OK	WikiSearchResponse	成功作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

作用域

名称	说明
vso.wiki	授予读取 Wiki、Wiki 网页和 Wiki 附件的功能。此外，还授予搜索 Wiki 页面的能力。

示例

示例请求

HTTP

POST https://almsearch.dev.azure.com/fabrikam/_apis/search/wikisearchresults?api-version=7.1

{
  "searchText": "Hello",
  "$skip": 0,
  "$top": 2,
  "filters": {
    "Project": [
      "Search",
      "Release"
    ]
  },
  "$orderBy": null,
  "includeFacets": true
}

示例响应

状态代码:: 200

{
  "count": 1,
  "results": [
    {
      "fileName": "Hello-world.md",
      "path": "/Hello-world.md",
      "collection": {
        "name": "test"
      },
      "project": {
        "id": "9811862e-ec6f-4e94-93bd-91555b51eedd",
        "name": "Release",
        "visibility": null
      },
      "wiki": {
        "id": "9c2aeff2-bab0-43e9-9eaa-bf8283be064b",
        "mappedPath": "/",
        "name": "Release.wiki",
        "version": "wikiMaster"
      },
      "contentId": "70c379b63ffa0795fdbfbc128e5a2818397b7ef8",
      "hits": [
        {
          "fieldReferenceName": "fileNames",
          "highlights": [
            "<highlighthit>Hello</highlighthit>-world.md"
          ]
        },
        {
          "fieldReferenceName": "content",
          "highlights": [
            "<highlighthit>Hello</highlighthit> world"
          ]
        }
      ]
    }
  ],
  "infoCode": 0,
  "facets": {
    "Project": [
      {
        "name": "Search",
        "id": "Search",
        "resultCount": 0
      },
      {
        "name": "Release",
        "id": "Release",
        "resultCount": 1
      }
    ]
  }
}

定义

名称	说明
Collection	定义集合的详细信息。
ProjectReference	定义项目的详细信息。
SortOption	定义如何对结果进行排序。
Wiki	定义 wiki 的详细信息。
WikiHit	在 Wiki 结果的字段中定义匹配的术语。
WikiResult	定义与 Wiki 搜索请求匹配的 Wiki 结果。
WikiSearchRequest	定义 Wiki 搜索请求。
WikiSearchResponse	定义 Wiki 搜索响应项。

Collection

Object

定义集合的详细信息。

名称	类型	说明
name	string	集合的名称。

ProjectReference

Object

定义项目的详细信息。

名称	类型	说明
id	string (uuid)	项目的 ID。
name	string	项目的名称。
visibility	string	项目的可见性。

SortOption

Object

定义如何对结果进行排序。

名称	类型	说明
field	string	应对其执行排序的字段名称。
sortOrder	string	要在其中对结果进行排序的顺序（ASC/DESC）。

Wiki

Object

定义 wiki 的详细信息。

名称	类型	说明
id	string	Wiki 的 ID。
mappedPath	string	Wiki 的映射路径。
name	string	Wiki 的名称。
version	string	Wiki 的版本。

WikiHit

Object

在 Wiki 结果的字段中定义匹配的术语。

名称	类型	说明
fieldReferenceName	string	突出显示字段的引用名称。
highlights	string[]	字段的匹配/突出显示的代码片段。

WikiResult

Object

定义与 Wiki 搜索请求匹配的 Wiki 结果。

名称	类型	说明
collection	Collection	结果文件的集合。
contentId	string	结果文件的 ContentId。
fileName	string	结果文件的名称。
hits	WikiHit[]	突出显示了与搜索请求匹配的字段片段。列表按代码片段的相关性进行排序。
path	string	结果文件所在的路径。
project	ProjectReference	Wiki 文档的项目详细信息。
wiki	Wiki	结果的 Wiki 信息。

WikiSearchRequest

Object

定义 Wiki 搜索请求。

名称	类型	说明
$orderBy	SortOption[]	用于对搜索结果进行排序的选项。如果设置为 null，则结果将按相关性进行排序。如果提供了多个排序选项，则结果按 OrderBy 中指定的顺序进行排序。
$skip	integer (int32)	要跳过的结果数。
$top	integer (int32)	要返回的结果数。
filters	object	要应用的筛选器。如果没有要应用的筛选器，则将其设置为 null。
includeFacets	boolean	用于选择结果中的分面的标志。默认行为为 false。
searchText	string	搜索文本。

WikiSearchResponse

Object

定义 Wiki 搜索响应项。

名称	类型	说明
count	integer (int32)	匹配的 Wiki 文档总数。
facets	object	一个字典，用于存储针对每个方面 `Filter` 对象的数组。
infoCode	integer (int32)	指示任何其他信息的数字代码：0 - 正常，1 - 帐户正在重新编制索引，2 - 帐户索引尚未启动，3 - 请求无效，4 - 不支持前缀通配符查询，5 - 不支持代码分面的多字，6 - 帐户正在载入或重新编制索引，7 - 正在载入或重新编制帐户索引，8 - 允许的最大值修整 9 - 分支正在编制索引， 10 - 未启用分面，11 - 无法访问工作项，19 - 不支持包含代码类型筛选器的短语查询，20 - 不支持具有代码类型筛选器的通配符查询。任何其他信息代码都用于内部目的。
results	WikiResult[]	最匹配的 Wiki 文档列表。

通过

Wiki Search Results - Fetch Wiki Search Results

URI 参数

请求正文

响应

安全性

oauth2

作用域

示例

示例请求

示例响应

定义

Collection

ProjectReference

SortOption

Wiki

WikiHit

WikiResult

WikiSearchRequest

WikiSearchResponse