Lister et récupérer des documents

Voici comment parcourir l’intégralité de votre corpus dans l’ordre, alors que la recherche classe les documents par pertinence par rapport à une requête. La liste vous permet de synchroniser, d’auditer ou de construire votre propre index sur les données détenues par Nordvec. La liste ne renvoie que les métadonnées, sans le contenu des documents.

Liste avec pagination par curseur

/documents/list renvoie une page de documents ainsi qu’un nextCursor opaque. Transmettez ce curseur pour obtenir la page suivante, et arrêtez-vous lorsque hasMore est 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
}

Pour parcourir toutes les pages, bouclez jusqu’à ce que hasMore soit false, en transmettant à chaque fois le nextCursor de la réponse précédente :

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

Filtres et tri

Tous les filtres sont optionnels et se combinent avec un ET logique. Le tri par défaut est du plus récent au plus ancien.

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

Récupérer un seul document

/documents/{id} renvoie tous les détails d’un document (et pas seulement les métadonnées de la liste). Utilisez cette méthode après avoir obtenu un identifiant via une liste ou un résultat de recherche.

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

Récupérer plusieurs documents en une fois

Pour résoudre un ensemble d’identifiants en un seul appel, envoyez-les en POST à /documents/batch au lieu d’effectuer une requête par identifiant.

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

Étapes suivantes