認証 | Minds

すべてのMinds APIリクエストには、APIキーを使用した認証が必要です。APIキーはアカウントに固有で、リソースへの安全なアクセスを提供します。

APIキーの取得

Mindsアカウントにログインします
設定 → APIキーに移動します
新しいAPIキーを生成をクリックします
APIキーをすぐにコピーします（再度見ることはできません！）

APIキーはminds_で始まり、次のようになります: minds_0000111122223333444455556666777788889999aaaabbbb

APIキーの使用

すべてのリクエストのAuthorizationヘッダーにAPIキーを含めます:

Authorization: Bearer minds_your_api_key_here

リクエストの例

curl -X GET "https://getminds.ai/api/v1/api-keys" \
  -H "Authorization: Bearer minds_your_api_key"

セキュリティのベストプラクティス

キーを秘密に保つ

絶対に APIキーをバージョン管理にコミットしないでください
絶対に 公共のフォーラムやチャットでキーを共有しないでください
環境変数や安全なボールトにキーを保存します
セキュリティのために定期的にキーをローテーションします

環境変数を使用する

# Set your key as an environment variable
export MINDS_API_KEY="minds_your_api_key_here"

# Use it in requests
curl -X GET "https://getminds.ai/api/v1/api-keys" \
  -H "Authorization: Bearer $MINDS_API_KEY"

定期的にキーをローテーションする

キーが侵害された疑いがある場合:

新しいAPIキーを生成します
アプリケーションを新しいキーを使用するように更新します
古いキーを削除します

認証されたユーザーの特定

APIキーが有効であることを確認し、それがどのアカウントに属しているかを特定します:

GET /api/v1/auth/me

レスポンス:

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

APIキーに関連付けられたユーザーIDを返します。起動時やキーをローテーションした後に資格情報を確認するのに便利です。キーが欠落しているか無効な場合は401 Unauthorizedを返します。

APIキーの管理

APIキーの一覧表示

GET /api/v1/api-keys

メタデータ付きのAPIキーのリストを返します（実際のキー値は決して返されません）:

[
  {
    "id": "key-id",
    "name": "prod",
    "createdAt": "2025-12-10T12:00:00.000Z",
    "lastUsedAt": "2025-12-10T13:00:00.000Z"
  }
]

新しいAPIキーの作成

POST /api/v1/api-keys

ヘッダー:

Content-Type: application/json

リクエストボディ（オプション）:

{
  "name": "prod"
}

オプションのnameフィールドは、キーの人間が読めるラベルです（文字列、1–100文字）。リストエンドポイントや設定UIでキーを特定するのに役立ちます。空白はトリムされ、空または欠落した値はnullとして保存されます。空のリクエストボディも受け入れられ、名前のないキーが作成されます。

レスポンスには実際のキーが含まれます（これが唯一見ることができる時です）:

{
  "id": "new-key-id",
  "name": "prod",
  "key": "minds_0000111122223333444455556666777788889999aaaabbbb",
  "createdAt": "2025-12-10T12:00:00.000Z"
}

名前付きの例

curl -X POST "https://getminds.ai/api/v1/api-keys" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"prod"}'

⚠️ 重要: keyの値をすぐに保存してください！再度取得することはできません。

APIキーの削除

DELETE /api/v1/api-keys/{keyId}

成功時には空のボディで204 No Contentを返します。

認証エラー

401 Unauthorized

APIキーが欠落しているか無効です。

{
  "statusCode": 401,
  "statusMessage": "Unauthorized",
  "message": "Invalid or missing API key"
}

解決策:

Authorizationヘッダーが含まれていることを確認してください
APIキーが正しいことを確認してください
Bearerプレフィックスを使用していることを確認してください
古いキーが削除された場合は新しいキーを生成してください

プランベースのアクセス

APIアクセスは有料プランでサポートされる機能であり、製品上に表示される、または契約で合意されたリソース、回答数、ワークスペースの制限に従います。制限値をコードに固定せず、構造化されたPLAN_LIMITとplan_limited応答を処理してください。IndividualプランはAPIペイロードでは"premium"と表示されます。

プランを見る