Authenticatie
API-sleutels, de basis-URL, wat elke sleutelscope toestaat en hoe AI-agents inloggen zonder sleutel.
Basis-URL
https://app.argorant.com/api/v1API-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:
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.
| Scope | Staat toe | Kan kosten |
|---|---|---|
argorant:read_counts | Tellingen, woordenlijsten, account, campagnes lezen, de inbox, mailboxen en webhooks | Niets |
argorant:search_segments | Gemaskeerde voorbeelden van mensen en bedrijven | Niets |
argorant:manage_lists | Lijsten, campagnes, starten, antwoorden beantwoorden, statussen, mailboxen, de blokkeerlijst, webhooks, mailboxbestellingen | Mailboxbestellingen kosten geld, na een ja |
argorant:unlock_contacts | Vrijgeven, telefoonnummers, personen verrijken, de e-mailfinder | Credits |
argorant:create_exports | Exports en lijstexports | Credits |
argorant:verify_emails | Je eigen lijsten controleren | Credits, 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.
Introductie
Wat de Argorant API doet, wat gratis is, wat credits kost en hoe de API, de command line-tool en de MCP-server samenwerken.
Fouten en limieten
De ene foutvorm, elke foutcode, de request-id, requestlimieten per plan, limieten op zoekopdrachten en tellingen, daglimieten, pagina's en veilige herhalingen.