ArgorantDocs

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

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

Chiavi 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:

Shell
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.

ScopeConsentePuò costare
argorant:read_countsConteggi, liste di parole, account, lettura delle campagne, la posta in arrivo, le caselle e i webhookNulla
argorant:search_segmentsAnteprime mascherate di persone e aziendeNulla
argorant:manage_listsListe, campagne, avvio, risposte alle risposte, stati, caselle, la lista di esclusione, webhook, ordini di caselleGli ordini di caselle costano denaro, dopo un sì
argorant:unlock_contactsSblocchi, numeri di telefono, arricchimento delle persone, la ricerca emailCrediti
argorant:create_exportsEsportazioni ed esportazioni di listeCrediti
argorant:verify_emailsControllo delle tue listeCrediti, 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.

In questa pagina