Autenticazione
Chiavi API, l'URL di base, cosa consente ogni scope di una chiave e come gli agenti AI accedono senza chiave.
URL di base
https://app.argorant.com/api/v1Chiavi API
Accedi su app.argorant.com/profile e crea una chiave in Chiavi API. Le chiavi iniziano con ag_live_ e vengono mostrate una sola volta. Dai a ogni chiave il nome di ciò che la usa, come zapier, ci o laptop, così puoi revocarne una senza rompere le altre.
Invia la chiave con ogni chiamata:
curl "https://app.argorant.com/api/v1/account" \
-H "Authorization: Bearer $ARGORANT_API_KEY"La risposta ti dice per chi agisce la chiave, il tuo piano, i tuoi crediti, quante richieste al minuto la chiave può inviare e quanto resta dei limiti di oggi. Chiamala prima di un lavoro grande.
Le chiavi API funzionano durante la prova di 7 giorni e su ogni piano. Lo strumento da riga di comando legge la stessa chiave da npx argorant login o dalla variabile ARGORANT_API_KEY.
Scope
Una chiave creata nell'app ha tutti gli scope qui sotto. Una chiave più limitata riceve 403 con il codice scope_missing quando chiama qualcosa fuori dai suoi scope.
| Scope | Consente | Può costare |
|---|---|---|
argorant:read_counts | Conteggi, liste di parole, account, lettura delle campagne, la posta in arrivo, le caselle e i webhook | Nulla |
argorant:search_segments | Anteprime mascherate di persone e aziende | Nulla |
argorant:manage_lists | Liste, campagne, avvio, risposte alle risposte, stati, caselle, la lista di esclusione, webhook, ordini di caselle | Gli ordini di caselle costano denaro, dopo un sì |
argorant:unlock_contacts | Sblocchi, numeri di telefono, arricchimento delle persone, la ricerca email | Crediti |
argorant:create_exports | Esportazioni ed esportazioni di liste | Crediti |
argorant:verify_emails | Controllo delle tue liste | Crediti, mezzo credito per ogni nuovo controllo |
Gli agenti AI accedono, non vedono mai la chiave
I client MCP come Claude e ChatGPT si collegano a https://mcp.argorant.com/mcp e accedono con OAuth 2.1 (authorization code con PKCE). Agiscono per il tuo account con gli scope che approvi, e la tua chiave API non finisce mai in una chat. Vedi Collega un client.
Permessi all'interno di un workspace
Una chiave agisce come la persona che l'ha creata. Proprietari e membri vedono solo il proprio workspace. Alcune azioni, come ordinare caselle, sono riservate al proprietario del workspace; un membro riceve 403 con un messaggio chiaro che lo spiega. Gli elementi di altri workspace rispondono sempre 404 not_found, come gli elementi che non esistono.
Introduzione
Cosa fa l'API di Argorant, cosa è gratuito, cosa costa crediti, e come l'API, lo strumento da riga di comando e il server MCP lavorano insieme.
Errori e limiti
L'unica forma degli errori, ogni codice di errore, il request id, i limiti di richieste per piano, i limiti su ricerche e conteggi, i limiti giornalieri, le pagine e i nuovi tentativi sicuri.