Liste og hente dokumenter
Gennemse dine dokumenter med markørbaseret paginering, filtrer og sorter dem, og hent ét eller flere efter id.
Her er hvordan du gennemgår hele dit korpus med Nordvec. Mens søgning rangerer dokumenter efter relevans for en forespørgsel, gennemløber listing hele dit korpus i rækkefølge. Brug det til at synkronisere, revidere eller bygge dit eget indeks over, hvad Nordvec indeholder. Listing returnerer kun metadata, ikke dokumentindhold.
List med cursor-paginering
/documents/list returnerer en side med dokumenter plus en uigennemsigtig nextCursor. Giv den cursor tilbage for at få den næste side, og stop, når hasMore er 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
}For at gennemløbe alle sider, loop indtil hasMore er false, og giv den forrige respons' nextCursor hver gang:
curl "https://nordvec.com/api/v1/documents/list?limit=50&cursor=eyJrIjoi…" \
-H "Authorization: Bearer $NORDVEC_API_KEY"Cursoren er uigennemsigtig, så du må ikke parse eller konstruere den. Giv nøjagtigt tilbage, hvad den forrige respons returnerede. En manipuleret cursor afvises.
Filtrer og sorter
Alle filtre er valgfrie og kombineres med AND. Sortering er som standard nyeste først.
| Felt | Type | Noter |
|---|---|---|
limit | integer | 1 til 200 (standard 50). |
cursor | string | Uigennemsigtig cursor fra den forrige side. |
datasource | string | Begræns til én datasource. |
status | enum | indexed, processing eller failed. |
sourceProvider | string | Begræns til én connector provider. |
createdAfter / createdBefore | string | ISO 8601-tidspunkter. |
sort | enum | createdAt (standard), updatedAt eller title. |
direction | enum | desc (standard) eller asc. |
curl "https://nordvec.com/api/v1/documents/list?status=indexed&datasource=finance&sort=updatedAt&direction=desc&limit=100" \
-H "Authorization: Bearer $NORDVEC_API_KEY"Hent et enkelt dokument
/documents/{id} returnerer ét dokuments fulde detaljer (ikke kun listemetadata). Brug det, når du har et id fra en liste eller søgeresultat.
curl https://nordvec.com/api/v1/documents/DOCUMENT_ID \
-H "Authorization: Bearer $NORDVEC_API_KEY"Hent mange på én gang
For at hente et sæt ids i ét kald, send dem med POST til /documents/batch i stedet for at lave én forespørgsel pr. id.
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"] }'Listing, ligesom søgning, returnerer kun dokumenter, du har adgang til at se, og en status på processing eller failed betyder, at dokumentet endnu ikke kan hentes.
Se Dokumenter & søgning for livscyklussen.