ArgorantDocs

Authenticatie

API-sleutels, de basis-URL, wat elke sleutelscope toestaat en hoe AI-agents inloggen zonder sleutel.

Basis-URL

Text
https://app.argorant.com/api/v1

API-sleutels

Log in op app.argorant.com/profile en maak een sleutel aan onder API-sleutels. Sleutels beginnen met ag_live_ en worden maar één keer getoond. Geef elke sleutel de naam van wat hem gebruikt, zoals zapier, ci of laptop, zodat je er één kunt intrekken zonder de andere stuk te maken.

Stuur de sleutel mee met elke aanroep:

Shell
curl "https://app.argorant.com/api/v1/account" \
  -H "Authorization: Bearer $ARGORANT_API_KEY"

De response vertelt je namens wie de sleutel handelt, je plan, je credits, hoeveel requests per minuut de sleutel mag sturen en wat er over is van de limieten van vandaag. Roep dit aan voor een grote taak.

API-sleutels werken tijdens de proefperiode van 7 dagen en op elk plan. De command line-tool leest dezelfde sleutel uit npx argorant login of uit de variabele ARGORANT_API_KEY.

Scopes

Een sleutel die je in de app aanmaakt, heeft alle scopes hieronder. Een sleutel met minder scopes krijgt 403 met de code scope_missing als hij iets buiten zijn scopes aanroept.

ScopeStaat toeKan kosten
argorant:read_countsTellingen, woordenlijsten, account, campagnes lezen, de inbox, mailboxen en webhooksNiets
argorant:search_segmentsGemaskeerde voorbeelden van mensen en bedrijvenNiets
argorant:manage_listsLijsten, campagnes, starten, antwoorden beantwoorden, statussen, mailboxen, de blokkeerlijst, webhooks, mailboxbestellingenMailboxbestellingen kosten geld, na een ja
argorant:unlock_contactsVrijgeven, telefoonnummers, personen verrijken, de e-mailfinderCredits
argorant:create_exportsExports en lijstexportsCredits
argorant:verify_emailsJe eigen lijsten controlerenCredits, een halve credit per nieuwe controle

AI-agents loggen in, ze zien de sleutel nooit

MCP-clients zoals Claude en ChatGPT maken verbinding met https://mcp.argorant.com/mcp en loggen in met OAuth 2.1 (authorization code met PKCE). Ze handelen voor je account met de scopes die je goedkeurt, en je API-sleutel komt nooit in een chat terecht. Zie Een client koppelen.

Rechten binnen een workspace

Een sleutel handelt als de persoon die hem heeft aangemaakt. Eigenaren en leden zien alleen hun eigen workspace. Sommige acties, zoals mailboxen bestellen, zijn voor de eigenaar van de workspace; een lid krijgt dan 403 met een duidelijke melding. Items van andere workspaces geven altijd 404 not_found, net als items die niet bestaan.

Op deze pagina