Met een API-sleutel kan een programma namens je account handelen. De commandoregeltool, de REST API, een stap in Zapier of je eigen script gebruiken er allemaal een. AI-apps die inloggen ondersteunen, zoals Claude en ChatGPT, hebben helemaal geen sleutel nodig.
Een sleutel aanmaken
Open Instellingen en kies API-sleutels.
- Typ een naam in het veld naast Nieuwe sleutel. Noem hem naar de plek waar hij wordt gebruikt, zoals "cli op mijn laptop" of "zapier".
- Klik op Sleutel aanmaken.
- Kopieer de sleutel meteen. Hij begint met
ag_live_en wordt maar één keer volledig getoond. Daarna toont de lijst de eerste tekens, wanneer hij is aangemaakt en wanneer hij voor het laatst is gebruikt.
Bewaar de sleutel in een wachtwoordmanager of in de geheime instellingen van je tool. Zet hem nooit in een gedeeld document, een screenshot of een chat.
De sleutel gebruiken
De commandoregeltool vraagt één keer om de sleutel als je npx argorant login uitvoert en bewaart hem op je computer. Bij de REST API stuur je hem bij elk verzoek mee in een header.
curl https://app.argorant.com/api/mcp/account \
-H "Authorization: Bearer ag_live_..."Die eerste aanroep toont je plan en saldo, een goede manier om te controleren of de sleutel werkt. API-sleutels en de REST API noemt de belangrijkste endpoints, en de Argorant CLI behandelt de commandoregeltool.
Eén sleutel per tool
Geef elke tool en elke persoon een eigen sleutel. Dan zie je welke sleutel wanneer is gebruikt en kun je er een uitschakelen zonder de rest te breken. Sleutels delen de credits van je account, dus een sleutel heeft geen eigen saldo. Elke sleutel heeft een eigen snelheidslimiet, en zoekopdrachten hebben tijdens de proefperiode daglimieten. Snelheidslimieten en daglimieten geeft de cijfers per plan.
Vervangen en intrekken
Wil je een sleutel vervangen, maak dan eerst de nieuwe aan, zet die in de tool, controleer of hij werkt en klik daarna op Intrekken naast de oude. Intrekken werkt meteen. Het volgende verzoek met de oude sleutel wordt geweigerd.
Komt een sleutel ergens terecht waar hij niet hoort, zoals een openbare coderepository of een gedeeld scherm, trek hem dan meteen in en maak een nieuwe aan. Kijk daarna in je recente exports of er iets is gedraaid dat jij niet hebt gestart. Wat te doen als een API-sleutel uitlekt heeft de volledige checklist.
Webhooks
Onder de sleutels kun je een webhook toevoegen. Argorant roept dan je adres aan als er iets gebeurt, bijvoorbeeld als een export klaar is, een lijst helemaal gevuld is, er een antwoord binnenkwam of een campagne werd gepauzeerd. Plak het adres onder Nieuwe webhook, kies de events en klik op Webhook toevoegen. Elke aanroep is ondertekend, zodat je server kan controleren dat hij van ons komt. Webhooks laat zien wat elk event bevat.
