Поиск по порталу

Поиск по порталу

Выдает результаты полнотекстового поискового запроса. Проекты/публикации, закрытые для пользователя, отправившего запрос, будут пропущены. Для неавторизованных пользователей выдаются результаты только из открытых публикаций.

Query Parameters
  • q
    string
    required

    Полнотекстовый поисковый запрос. Может содержать любые поддерживаемые операторы поиска.

    Examplenebula
  • count
    integer

    Максимальное количество выдаваемых результатов. Если не указано, то выдается 10 лучших результатов. Если указано отрицательное число, то выдаются все результаты поиска независимо от их общего количества.

    Example2
  • projectIds
    string

    Разделенный запятыми список идентификаторов проектов/публикаций для поиска. Идентификаторы проектов/публикаций, к которым у вас нет доступа, будут игнорироваться.

    Exampleproject-deep-space-exploration,space-program-pub
  • lang
    string

    Четырехбуквенный код языка. Если указано, то поиск ведется только по проектам/публикациям на этом языке.

    Exampleen-us
  • isReturnSnippets
    boolean

    Если условие верное, то в теле ответа выдаются ftsTitle и ftsSnippet.

    Exampletrue
  • format
    string enum

    Формат поля compiledContent в ответе. Допустимые значения: html, md. По умолчанию: html.

    Examplehtml
    • html
    • md
Responses
GET/search
curl --location -g --request GET 'https://{portal-url}/api/v2/search?count=2&projectIds=project-deep-space-exploration,space-program-pub&lang=en-us&isReturnSnippets=true&q=nebula'


[
  {
    "assigneeUserName": "admin",
    "compiledContent": null,
    "compiledContentType": null,
    "createdOn": "2021-05-10T12:32:25",
    "ftsSnippet": "...A&#160;<strong>nebula</strong>&#160;( Latin&#160;for &#39;cloud&#39; or &#39;fog&#39;...) is an interstellar cloud&#160;of dust, hydrogen, helium&#160;and other ionized gases...",
    "ftsTitle": "New topic created with API",
    "fullUrl": "https://docs.hedron.org/articles/project-deep-space-exploration/nebula",
    "id": "nebula",
    "indexKeywords": [
      "cluster",
      "N",
      "nebula",
      "N, nebula"
    ],
    "modifiedOn": "2022-11-07T12:59:40",
    "ownerUserName": "admin",
    "projectId": "project-deep-space-exploration",
    "projectTitle": "Project Deep Space Exploration",
    "statusName": null,
    "title": "New topic created with API",
    "tocNodeId": "cd1ad87f-55a4-46e5-b496-c3434d555cd1",
    "isAutoTopic": false
  },
  {
    "assigneeUserName": "admin",
    "compiledContent": null,
    "compiledContentType": null,
    "createdOn": "2022-10-25T13:32:19",
    "ftsSnippet": "...A&#160;<strong>nebula</strong>&#160;( Latin&#160;for &#39;cloud&#39; or &#39;fog&#39;...) is an interstellar cloud&#160;of dust, hydrogen, helium&#160;and other ionized gases...",
    "ftsTitle": "<strong>Nebula</strong>",
    "fullUrl": "https://docs.hedron.org/articles/space-program-pub/nebula",
    "id": "nebula",
    "indexKeywords": [],
    "modifiedOn": "2022-10-25T13:32:27",
    "ownerUserName": "admin",
    "projectId": "space-program-pub",
    "projectTitle": "Space Program Pub",
    "statusName": null,
    "title": "Nebula",
    "tocNodeId": "cd1ad87f-55a4-46e5-b496-c3434d555cd1",
    "isAutoTopic": false
  }
]

OK