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

# 概要

> Server APIの概要と認証方式

## Server APIについて

Server APIは、API Key認証を使用してサーバーサイドから呼び出すAPIです。
管理操作や自社サーバー経由でのメッセージ投稿など、バックエンドシステムからの操作に使用します。

## 主な用途

<CardGroup cols={2}>
  <Card title="ユーザー管理" icon="users">
    ユーザーの作成・更新・削除、トークン発行
  </Card>

  <Card title="Bot管理" icon="robot">
    チャットボットの作成とメッセージ送信
  </Card>

  <Card title="管理操作" icon="shield">
    チャンネル管理、メッセージ管理などの管理者操作
  </Card>

  <Card title="サーバー経由の操作" icon="server">
    自社サーバーを経由したメッセージ投稿やチャンネル操作
  </Card>
</CardGroup>

## 認証方式

Server APIでは、管理画面で発行したAPI Keyを使用します。

```bash theme={null}
curl -X POST https://<application_id>.chat.rheel.net/v1/users \
  -H "X-Rheel-API-Key: <API_KEY>" \
  -H "Content-Type: application/json"
```

<Warning>
  API Keyは秘密情報です。クライアントサイドのコードに含めず、必ずサーバーサイドでのみ使用してください。
</Warning>

## ベースURL

```
https://<application_id>.chat.rheel.net/v1
```

`<application_id>`は管理画面で作成したアプリケーションのIDに置き換えてください。

## レスポンス形式

すべてのレスポンスはJSON形式で返されます。

### 成功レスポンス

```json theme={null}
{
  "id": "user_123",
  "name": "山田太郎",
  "created_at": "2025-03-21T10:00:00Z"
}
```

### エラーレスポンス

```json theme={null}
{
  "error": {
    "code": "ERROR_CODE",
    "message": "エラーの詳細メッセージ"
  }
}
```

## HTTPステータスコード

| コード   | 説明          |
| ----- | ----------- |
| `200` | 成功          |
| `400` | リクエストが不正です  |
| `401` | 認証に失敗しました   |
| `403` | アクセス権がありません |
| `404` | リソースが存在しません |
| `500` | サーバーエラー     |

## 次のステップ

<CardGroup cols={2}>
  <Card title="API Overview" icon="book" href="/api-reference/overview">
    Server APIの詳細な概要を確認
  </Card>

  <Card title="ユーザー管理" icon="users" href="/api-reference/endpoint/server-api/users/ユーザーの作成">
    ユーザー作成・管理APIを確認
  </Card>

  <Card title="Bot管理" icon="robot" href="/api-reference/bots-overview">
    Bot機能の概要と使い方
  </Card>

  <Card title="全体ドキュメント" icon="home" href="/">
    Rheel Chat APIドキュメントトップへ
  </Card>
</CardGroup>