Listaa ja hae dokumentteja

Kun haku järjestää dokumentit kyselyn relevanssin mukaan, listaus käy läpi koko tietokantasi järjestyksessä. Käytä sitä synkronointiin, tarkastukseen tai oman indeksisi rakentamiseen siitä, mitä Nordvec sisältää. Listaus palauttaa vain metatiedot, ei dokumentin sisältöä.

Listaus kursori-paginointia käyttäen

/documents/list palauttaa sivun dokumentteja sekä läpinäkymättömän nextCursor-kursorin. Lähetä kyseinen kursori takaisin saadaksesi seuraavan sivun, ja lopeta, kun hasMore on 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
}

Käydäksesi kaikki sivut läpi, toista silmukkaa kunnes hasMore on false, välittäen aina edellisen vastauksen nextCursor-kursorin:

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

Suodatus ja järjestäminen

Kaikki suodattimet ovat valinnaisia ja yhdistyvät AND-operaattorilla. Oletuksena järjestys on uusin ensin.

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

Yhden dokumentin hakeminen

/documents/{id} palauttaa yhden dokumentin täydelliset tiedot (ei pelkästään listauksen metatietoja). Käytä sitä, kun sinulla on tunniste saatavilla listauksesta tai hakutuloksesta.

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

Useiden dokumenttien hakeminen kerralla

Jos haluat hakea useita tunnisteita yhdellä kutsulla, lähetä ne POST-pyynnöllä /documents/batch-osoitteeseen yhden pyynnön sijaan per tunniste.

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

Seuraavat vaiheet