Przeglądaj i pobieraj dokumenty

Gdzie wyszukiwanie szereguje dokumenty według trafności do zapytania, listing przegląda cały korpus w kolejności. Użyj go do synchronizacji, audytu lub zbudowania własnego indeksu nad tym, co przechowuje Nordvec. Listing zwraca tylko metadane, bez treści dokumentu.

Listing z paginacją kursorową

/documents/list zwraca stronę dokumentów wraz z nieprzejrzystym nextCursor. Przekaż ten kursor z powrotem, aby uzyskać następną stronę, i zakończ, gdy hasMore będzie false.

curl "https://nordvec.com/api/v1/documents/list?limit=50" \
  -H "Authorization: Bearer $NORDVEC_API_KEY"

{
  "items": [
    { "id": "…", "title": "Q3 Financial Report", "status": "indexed", "datasource": "finance", "created_at": "2026-04-01T10:00:00Z" }
  ],
  "nextCursor": "eyJrIjoi…",
  "hasMore": true
}

Aby przejść przez wszystkie strony, wykonuj pętlę, dopóki hasMore nie będzie false, przekazując za każdym razem nextCursor z poprzedniej odpowiedzi:

curl "https://nordvec.com/api/v1/documents/list?limit=50&cursor=eyJrIjoi…" \
  -H "Authorization: Bearer $NORDVEC_API_KEY"

Filtrowanie i sortowanie

Wszystkie filtry są opcjonalne i łączone za pomocą AND. Sortowanie domyślnie ustawione jest na najnowsze pierwsze.

curl "https://nordvec.com/api/v1/documents/list?status=indexed&datasource=finance&sort=updatedAt&direction=desc&limit=100" \
  -H "Authorization: Bearer $NORDVEC_API_KEY"

Pobieranie pojedynczego dokumentu

/documents/{id} zwraca pełne szczegóły jednego dokumentu (nie tylko metadane z listy). Użyj go, gdy masz już identyfikator z listy lub wyniku wyszukiwania.

curl https://nordvec.com/api/v1/documents/DOCUMENT_ID \
  -H "Authorization: Bearer $NORDVEC_API_KEY"

Pobieranie wielu naraz

Aby rozwiązać zestaw identyfikatorów w jednym wywołaniu, wyślij je metodą POST do /documents/batch, zamiast robić jedno żądanie na identyfikator.

curl https://nordvec.com/api/v1/documents/batch \
  -H "Authorization: Bearer $NORDVEC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "ids": ["DOCUMENT_ID_1", "DOCUMENT_ID_2"] }'

Następne kroki