Pobierz listę bazy wiedzy

Pobierz listę dostępnych dokumentów bazy wiedzy

Nagłówki

xi-api-keystringOpcjonalny

Parametry zapytania

page_sizeintegerOpcjonalny1-100Domyślnie 30

Maksymalna liczba dokumentów do zwrócenia. Nie może przekraczać 100, domyślnie 30.

searchstring or nullOpcjonalny

Jeśli podano, endpoint zwraca tylko dokumenty bazy wiedzy, których nazwy zaczynają się od tego ciągu.

show_only_owned_documentsbooleanOpcjonalnyDomyślnie falseDeprecated

Jeśli ustawiono true, endpoint zwróci tylko dokumenty należące do ciebie, a nie udostępnione przez inne osoby. Przestarzałe: użyj zamiast tego created_by_user_id.

created_by_user_idstring or nullOpcjonalny

Filtruj dokumenty według ID użytkownika, który je utworzył. Po ustawieniu zwracane są tylko dokumenty utworzone przez tego użytkownika. Ma pierwszeństwo przed show_only_owned_documents. Użyj „@me”, aby wskazać uwierzytelnionego użytkownika.

typeslist of enums or nullOpcjonalny

Jeśli podano, endpoint zwróci tylko dokumenty danych typów.

Dozwolone wartości:
parent_folder_idstring or nullOpcjonalny

Jeśli ustawione, endpoint zwróci tylko dokumenty będące bezpośrednimi elementami podanego folderu.

ancestor_folder_idstring or nullOpcjonalny

Jeśli ustawione, endpoint zwróci tylko dokumenty będące potomkami podanego folderu.

folders_firstbooleanOpcjonalnyDomyślnie false

Czy foldery powinny być zwracane jako pierwsze na liście dokumentów.

sort_directionenumOpcjonalny

Kierunek sortowania wyników

Dozwolone wartości:
sort_byenum or nullOpcjonalny

Pole, według którego sortować wyniki

Dozwolone wartości:
cursorstring or nullOpcjonalny

Służy do pobrania następnej strony. Kursor jest zwracany w odpowiedzi.

Odpowiedź

Pomyślna odpowiedź

documentslist of objects
has_moreboolean
next_cursorstring or nullOpcjonalny

Błędy

422
Unprocessable Entity Error