ArgorantDocs

認証

APIキー、ベースURL、各キーのスコープで許可される操作、AIエージェントがキーなしでログインする方法を説明します。

ベースURL

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

APIキー

app.argorant.com/profileにログインし、「APIキー」でキーを作成します。キーはag_live_で始まり、一度しか表示されません。各キーにはzapier、ci、laptopのように、そのキーを使うものの名前を付けてください。そうすれば、ほかのキーに影響を与えずに1つだけ取り消せます。

すべての呼び出しでキーを送信します。

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

応答には、キーが誰として動作するか、プラン、クレジット、キーが1分間に送れるリクエスト数、今日の上限の残りが含まれます。大きな作業の前に呼び出してください。

APIキーは7日間の無料トライアル中も、すべてのプランでも使えます。コマンドラインツールは、npx argorant loginまたは変数ARGORANT_API_KEYから同じキーを読み取ります。

スコープ

アプリで作成したキーには、以下のすべてのスコープが含まれます。スコープを絞ったキーでスコープ外の操作を呼び出すと、コードscope_missing付きの403が返ります。

スコープ許可される操作費用が発生するもの
argorant:read_counts件数、単語リスト、アカウント、キャンペーン、受信トレイ、メールボックス、Webhookの読み取りなし
argorant:search_segments人物と企業のマスクされたプレビューなし
argorant:manage_listsリスト、キャンペーン、開始、返信への回答、ステータス、メールボックス、ブロックリスト、Webhook、メールボックスの注文メールボックスの注文は、承認後に料金がかかります
argorant:unlock_contacts表示、電話番号、人物のデータ補完、メールアドレス検索クレジット
argorant:create_exportsエクスポートとリストのエクスポートクレジット
argorant:verify_emails手持ちのリストのチェッククレジット。新たにチェックするごとに0.5クレジット

AIエージェントはログインし、キーを見ることはありません

ClaudeやChatGPTなどのMCPクライアントはhttps://mcp.argorant.com/mcpに接続し、OAuth 2.1(PKCE付きの認可コード)でログインします。承認したスコープであなたのアカウントとして動作し、APIキーがチャットに入ることはありません。クライアントを接続するを参照してください。

ワークスペース内の権限

キーは、そのキーを作成した人として動作します。オーナーとメンバーが見られるのは、自分のワークスペースだけです。メールボックスの注文など一部の操作はワークスペースのオーナー専用で、メンバーが行うと、その旨を説明するメッセージ付きの403が返ります。ほかのワークスペースの項目は、存在しない項目と同じく常に404 not_foundを返します。

このページの内容