Filtrowanie i doprecyzowanie wyszukiwania

/documents/search przeszukuje pełnotekstowo tytuły i treść twoich dokumentów, a następnie zwraca najlepsze dopasowania, każde z wynikiem trafności oraz dokumentem źródłowym, z którego pochodzi. Ten przewodnik pokazuje, jak zawęzić te wyniki za pomocą filtrów oraz jak odczytać odpowiedź.

Żądanie

Wymagany jest tylko query. Wszystko inne zawęża lub ogranicza wyniki.

curl https://nordvec.com/api/v1/documents/search \
  -H "Authorization: Bearer $NORDVEC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "renewal terms",
    "limit": 20,
    "datasource": "contracts",
    "sourceProvider": "google_drive",
    "createdAfter": "2026-01-01T00:00:00Z",
    "createdBefore": "2026-07-01T00:00:00Z"
  }'

Odpowiedź

{
  "results": [
    {
      "id": "…",
      "title": "Acme Corp Master Services Agreement",
      "snippet": "…renews automatically for successive twelve month terms…",
      "score": 0.82,
      "datasource": "contracts",
      "source_provider": "google_drive",
      "source_type": "…",
      "mime_type": "application/pdf",
      "status": "indexed",
      "created_at": "2026-02-14T09:00:00Z",
      "updated_at": "2026-02-14T09:00:00Z"
    }
  ],
  "totalCount": 7
}

Każdy wynik zawiera snippet z pasującym tekstem, score od 0 do 1 (wyższa wartość oznacza większą trafność) oraz metadane dokumentu źródłowego, dzięki którym możesz go prześledzić. totalCount to całkowita liczba dopasowanych dokumentów, która może być większa niż liczba results, o którą poprosiłeś za pomocą limit.

Odczytywanie wyników

• Wyniki są sortowane według trafności, najbardziej trafne jako pierwsze. Użyj score, aby ustalić próg odcięcia, jeśli zależy ci tylko na silnych dopasowaniach.
• totalCount vs results.length: results zawiera do limit elementów; totalCount to pełna liczba dopasowań. Jeśli totalCount jest znacznie większe niż twój limit, zaostrz query lub dodaj filtr, zamiast oczekiwać wszystkich dopasowań w jednym wywołaniu.
• Tylko zindeksowane dokumenty są przeszukiwalne. Dokument z status o wartości processing lub failed nie jest jeszcze dostępny; zobacz Dokumenty i wyszukiwanie, aby poznać cykl życia.

Następne kroki