Filtrér og forfin din søgning

/documents/search udfører fuldtekstsøgning på tværs af dine dokumenters titler og indhold og returnerer de bedste matches, hver med en relevansscore og det kilde- dokument, det stammer fra. Denne vejledning viser, hvordan du indsnævrer disse resultater med filtre, og hvordan du læser svaret.

Anmodningen

Kun query er påkrævet. Alt andet indsnævrer eller begrænser resultaterne.

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"
  }'

Svaret

{
  "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
}

Hvert resultat indeholder en snippet med den matchende tekst, en score fra 0 til 1 (højere er mere relevant), og kildedokumentets metadata, så du kan spore det tilbage. totalCount er det samlede antal dokumenter, der matchede, hvilket kan være større end antallet af results, du bad om med limit.

Læsning af resultaterne

• Resultaterne rangeres efter relevans, mest relevante først. Brug score til at fastsætte en grænse, hvis du kun ønsker stærke matches.
• totalCount vs. results.length: results indeholder op til limit elementer; totalCount er det fulde matchantal. Hvis totalCount er meget større end dit limit, så stram query eller tilføj et filter i stedet for at forvente alle matches tilbage i ét kald.
• Kun indekserede dokumenter kan søges i. Et dokument med status af processing eller failed er endnu ikke søgbart; se Dokumenter & søgning for livscyklussen.

Næste skridt