Aan de slag
Maak een API-sleutel en voer je eerste documentsuche uit tegen Nordvec.
Dit artikel helpt je om van nul naar je eerste zoekresultaat te komen.
1. Maak een API-sleutel aan
Meld je aan en maak een sleutel aan via de instellingen van jouw werkruimte. De onbewerkte sleutel wordt één keer getoond en daarna nooit meer, dus bewaar hem ergens veilig. Sleutels zijn gekoppeld aan jouw werkruimte en authenticeren als een bearer-token.
Bekijk Authenticatie voor de volledige levenscyclus (rotatie, intrekking, respijtperiodes).
2. Zoek in jouw documenten
Richt elke HTTP-client op het API-basisadres, https://nordvec.com/api/v1, en
stuur jouw zoekopdracht. Resultaten komen gerangschikt terug, elk met het brondocument waar het vandaan komt. query is verplicht; limit (1-50, standaard 20) is optioneel.
curl https://nordvec.com/api/v1/documents/search \
-H "Authorization: Bearer $NORDVEC_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "quarterly revenue", "limit": 10 }'Elk resultaat verwijst naar het brondocument, zodat je een match kunt verifiëren in plaats van hem zomaar te vertrouwen. Dat is het hele doel van het platform.
3. Werk met conversaties
Een conversatie is een chat die gebaseerd is op jouw documenten, waarbij elk antwoord geciteerd wordt. De API stelt je in staat om conversaties aan te maken en ze op te lijsten, op te halen en te doorzoeken:
# Create a conversation owned by your workspace
curl -X POST https://nordvec.com/api/v1/conversations \
-H "Authorization: Bearer $NORDVEC_API_KEY"