Dokumente auflisten und abrufen

Wo Suche Dokumente nach Relevanz zu einer Abfrage ein, listet die Auflistung Ihren gesamten Korpus in Reihenfolge auf. Verwenden Sie sie, um zu synchronisieren, zu prüfen oder Ihren eigenen Index über das aufzubauen, was Nordvec bereitstellt. Die Auflistung gibt nur Metadaten zurück, keinen Dokumentinhalt.

Auflistung mit Cursor-Paginierung

/documents/list gibt eine Seite mit Dokumenten sowie einen undurchsichtigen nextCursor zurück. Übergeben Sie diesen Cursor, um die nächste Seite zu erhalten, und beenden Sie den Vorgang, wenn hasMore false ist.

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
}

Um jede Seite zu durchlaufen, wiederholen Sie den Vorgang, bis hasMore false ist, und übergeben Sie dabei jedes Mal den nextCursor der vorherigen Antwort:

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

Filtern und Sortieren

Alle Filter sind optional und werden mit UND kombiniert. Die Sortierung erfolgt standardmäßig nach dem Neuesten zuerst.

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

Ein einzelnes Dokument abrufen

/documents/{id} gibt die vollständigen Details eines Dokuments zurück (nicht nur die Metadaten der Auflistung). Verwenden Sie es, nachdem Sie eine ID aus einer Auflistung oder einem Suchergebnis erhalten haben.

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

Mehrere Dokumente auf einmal abrufen

Um eine Menge von IDs in einem einzigen Aufruf aufzulösen, senden Sie diese per POST an /documents/batch, anstatt für jede ID eine separate Anfrage zu stellen.

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

Nächste Schritte