# BlueAI API ドキュメント

> マルナゲ プロダクトの REST API。ベース URL: `https://api.blueai.jp/api/v1`

## 認証
すべての API リクエストにはセッション Cookie または Bearer トークンによる認証が必要です。
詳細は認証ガイドを参照してください。

## ガイド
- 認証: API リクエストの認証方法
- エラーコード: 標準エラーレスポンスの形式とコード
- レートリミット: リクエスト制限と対処方法
- Webhook: Webhook によるイベント通知
- ページネーション: カーソルベースのページネーション
- メタデータ: リソースへのカスタムメタデータ
- リクエスト ID: 一意の ID によるリクエスト追跡
- べき等リクエスト: べき等キーによる安全なリトライ
- レスポンス展開: 関連リソースのインライン展開
- バージョニング: API バージョニング戦略

## CRM エンドポイント

### 案件 (Deals)
- GET /api/v1/crm/deals: 案件一覧の取得
- POST /api/v1/crm/deals: 案件の作成
- GET /api/v1/crm/deals/{id}: 案件の取得
- PUT /api/v1/crm/deals/{id}: 案件の更新
- DELETE /api/v1/crm/deals/{id}: 案件の削除

### 会社 (Companies)
- GET /api/v1/crm/companies: 会社一覧の取得
- POST /api/v1/crm/companies: 会社の作成
- GET /api/v1/crm/companies/{id}: 会社の取得
- PUT /api/v1/crm/companies/{id}: 会社の更新
- DELETE /api/v1/crm/companies/{id}: 会社の削除

### 連絡先 (Contacts)
- GET /api/v1/crm/contacts: 連絡先一覧の取得
- POST /api/v1/crm/contacts: 連絡先の作成
- GET /api/v1/crm/contacts/{id}: 連絡先の取得
- PUT /api/v1/crm/contacts/{id}: 連絡先の更新
- DELETE /api/v1/crm/contacts/{id}: 連絡先の削除

### 活動 (Activities)
- GET /api/v1/crm/activities: 活動一覧の取得
- POST /api/v1/crm/activities: 活動の作成
- GET /api/v1/crm/activities/{id}: 活動の取得
- PUT /api/v1/crm/activities/{id}: 活動の更新
- DELETE /api/v1/crm/activities/{id}: 活動の削除

## リンク
- API ドキュメント: https://docs.blueai.jp/api
- デザインシステム: https://design.blueai.co.jp