認証
APIキー、ベースURL、各キーのスコープで許可される操作、AIエージェントがキーなしでログインする方法を説明します。
ベースURL
https://app.argorant.com/api/v1APIキー
app.argorant.com/profileにログインし、「APIキー」でキーを作成します。キーはag_live_で始まり、一度しか表示されません。各キーにはzapier、ci、laptopのように、そのキーを使うものの名前を付けてください。そうすれば、ほかのキーに影響を与えずに1つだけ取り消せます。
すべての呼び出しでキーを送信します。
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を返します。