メインコンテンツへスキップ

​
API リファレンス

emma API で強力なインテグレーションを構築しましょう。

​
ベース URL

https://api.emma.ai/v1

​
認証

すべての API リクエストには Authorization ヘッダーに API キーが必要です。 
curl -X GET "https://api.emma.ai/v1/status" \
  -H "Authorization: Bearer YOUR_API_KEY"
API キーは emma ダッシュボード から取得できます。

​
クイックスタート

1

API キーを取得

emma ダッシュボードの設定 > API に移動します。
2

最初のリクエストを実行

簡単なステータスチェックで接続をテストします。
3

エンドポイントを探索

以下の利用可能なエンドポイントを参照します。

​
利用可能なエンドポイント

セッション

会話セッションの作成と管理。

メッセージ

メッセージの送信と応答の受信。

ナレッジ

ナレッジベースの管理。

Webhook

イベント通知の設定。

​
レート制限

プラン1分あたりのリクエスト数
Free10
Pro100
Enterpriseカスタム

​
レスポンス形式

すべてのレスポンスは JSON 形式で返されます： 
{
  "success": true,
  "data": {
    // レスポンスデータ
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

​
エラーハンドリング

エラーは一貫した形式に従います： 
{
  "success": false,
  "error": {
    "code": "invalid_request",
    "message": "エラーの説明"
  }
}
ステータスコード説明
400不正なリクエスト
401未認証
403禁止
404見つかりません
429レート制限
500内部サーバーエラー

​
SDK

Python

pip install emma-sdk

Node.js

npm install @emma/sdk

Go

go get emma.ai/sdk