> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moove.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Moove API Keys

> Moove API 用に権限を限定した API キーを作成し、1 回だけコピーして、不要になったら恒久的に失効させます。

キーを作り、1 回コピーして、Moove API の呼び出しに使いましょう。

<Info>
  **ウェブのみ**、[moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys) で。モバイル版はありません。
</Info>

## API キーはどう作りますか？

<Steps>
  <Step title="管理 → API キー を開く">
    ウェブのダッシュボードで。
  </Step>

  <Step title="名前を付ける">
    半年後に見て分かる名前を。どのサービス、どの環境向けかが分かるものです。
  </Step>

  <Step title="エージェントを選ぶ">
    **Moove Receive Agent** が現存する唯一のものです。そのエージェントに必要な権限へ展開されます。
  </Step>

  <Step title="キーをコピーする">
    <Warning>
      平文のキーは作成時に**1 回だけ**表示されます。その場でコピーし、シークレットマネージャーに保管してください。コピーせずにダイアログを閉じるとキーは使えなくなります。別のキーを作り直してください。
    </Warning>
  </Step>
</Steps>

ベース URL は `https://api.moove.xyz` です。

## 生の権限ではなく Moove Agents

選ぶのは**エージェント**であって、権限文字列ではありません。「Moove Receive Agent」は事業者が理解できる単位ですが、`payment_link:create` はそうではありません。

| エージェント                  | ステータス   | 付与される権限                                   |
| ----------------------- | ------- | ----------------------------------------- |
| **Moove Receive Agent** | **稼働中** | `payment_link:create`、`payment_link:read` |
| Moove Send Agent        | 近日公開    | —                                         |
| Moove Swap Agent        | 近日公開    | —                                         |
| Moove Ramp Agent        | 近日公開    | —                                         |

近日公開の 3 つは無効表示になります。選んでも何も付与されないキーができてしまうため、選択できないようになっています。

## API キーにできること・できないこと

<Note>
  キーは**あなたを絞り込んだもの**です。あなたのアカウントとして動き、あなたにできることの一部しかできません。

  **資金を動かすエンドポイントはありません。** 支払いリンクは常にあなた自身の既定のウォレットへ、そのウォレットのトークンで決済されます。呼び出し側が宛先を指定することはできません。漏れたキーができるのは*あなたに*支払う請求を作ることだけです。他の誰かに支払わせることはできません。
</Note>

キーが別のキーを作ることもできません。キーの管理はセッション認証のみのため、漏れたキーが自らの権限を広げることはできません。

## キーはどう安全に保ちますか？

<Warning>
  * シークレットマネージャーか環境変数に保管してください。バージョン管理には決して入れないこと。
  * プロンプト、チャット、Issue、スクリーンショットに貼り付けないでください。
  * サービスごとに別のキーを使えば、ひとつを失効させても他が止まりません。
  * 少しでも不安なキーは失効させてください。新しく作るのは数秒です。
</Warning>

## キーはいくつ持てますか？

アカウントあたり **10 個のアクティブなキー**までです。11 個目を作ろうとすると `TOO_MANY_API_KEYS` で拒否されます。使っていないものを先に失効させてください。

<Tip>
  この上限は、デプロイ単位ではなく統合単位でキーを分ける理由になります。実際に稼働しているサービスごとに 1 つのキーなら、把握しやすく、何かが変わったときに失効させるのも簡単です。
</Tip>

## キーはどう失効させますか？

<Steps>
  <Step title="キーのメニューを開く">
    **管理 → API キー** で、キーの行の **…** メニューを開き、**失効** を選びます。
  </Step>

  <Step title="確認する">
    確認のためもう一度 **失効** をクリックします。キーはただちに使えなくなります。
  </Step>
</Steps>

<Warning>
  **失効は恒久的です。** 取り消しはできません。平文は一度も保存されていないため、レコードが復元されたとしても失効したキーが再び使われることはありません。新しいキーを発行してください。
</Warning>

## キーはどう使いますか？

すべてのリクエストで `X-API-Key` ヘッダーに載せて送ります。

```bash theme={null}
curl -sS -X POST "https://api.moove.xyz/v1/payment-link" \
  -H "X-API-Key: $MOOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "toAmount": "49.99" }'
```

[Authentication →](/api-reference/authentication)

## 最初の呼び出しの前に

API は、支払いを受け取れないアカウントに対してリンクの作成を拒否します。[Mooveハンドル](/ja-jp/brand/moove-handle)を取得し、[決済トークン](/ja-jp/concepts/settlement-and-auto-routing)を設定した既定のウォレットがあることを確認してください。そうでないと `409` が返ります。

## 次に読むもの

<CardGroup cols={3}>
  <Card title="Authentication" icon="lock" href="/api-reference/authentication">
    ヘッダーのしくみ。
  </Card>

  <Card title="Moove Agentic Payments" icon="sparkles" href="/ja-jp/transact/moove-agentic-payments">
    統合を AI ツールに任せる。
  </Card>

  <Card title="Moove Payment Links API" icon="link" href="/api-reference/moove-receive/moove-payment-links">
    エンドポイントの全体。
  </Card>
</CardGroup>

限定でき、失効でき、あなたのもの。あなたのお金。あなたの一手。