Kibi API

Kibi REST APIは、外部アプリケーション、AIアシスタント、および自動化システムがKibi Connectのデータにアクセスできるようにします。APIを通じて、Wikiページ、ニュース記事、タスク、カレンダーのエントリなど、コンテンツの読み書きが可能です。

#APIアクセスを有効化

REST APIは、まずシステム管理者によって有効化される必要があります。設定は以下の場所にあります：

設定 → 統合 → REST API

ここで利用可能なオプションは以下の通りです：

REST APIを有効化

APIインターフェースをオン/オフします。
トークン作成を特定のロールに制限

有効化すると、選択されたロールを持つユーザーのみがAPIトークンを作成できます。個々のユーザーは、セキュリティタブのプロフィールの機能アクセスを通じて権限を付与することもできます。
IP制限を有効化

有効化すると、指定されたIPアドレスのみがAPIにアクセスできます。これは追加のセキュリティ層です。

各ユーザーは、自分のユーザープロフィールを通じて独自のAPIトークンを作成できます。次の場所に移動します：

ユーザープロフィール → 統合 → 新しいトークンを作成

トークンを作成する際に、以下を設定します：

作成後、トークンの値は1回のみ表示されます。すぐにコピーして、安全な場所（例：パスワードマネージャー）に保管してください。紛失した場合は、トークンを取り消して新しいものを作成する必要があります。

以下のスコープは、APIトークンのさまざまな領域へのアクセスを制御します：

スコープ	説明
`posts:read`	公開された投稿とニュースを読み取る
`posts:write`	投稿を作成、更新、削除する
`wiki:read`	Wikiページとドキュメントを読み取る
`wiki:write`	Wikiページを作成および更新する
`calendar:read`	カレンダーのエントリを読み取る
`calendar:write`	カレンダーのエントリを作成、更新、削除する
`groups:read`	公開グループ、メンバー、投稿、ファイルを読み取る
`surveys:read`	アンケートと結果を読み取る
`tasks:read`	タスクを読み取る（自分のタスクまたは割り当てられたタスクのみ）
`tasks:write`	タスクを作成および更新する
`users:read`	公開ユーザーディレクトリを読み取る（個人データは除く）
`chat:read`	会話とメッセージを読み取る
`chat:write`	メッセージを送信する（ボットおよび自動化用）
`notifications:read`	ユーザー通知を読み取る
`notifications:write`	ユーザーに通知を送信する（プッシュ通知を含む）
`search`	エンティティをまたぐ検索

すべてのAPIリクエストは、AuthorizationヘッダーにBearerトークンとしてトークンを含める必要があります：

curl -H "Authorization: Bearer kbc_IhrTokenHier" \
     https://ihre-firma.kibi.de/api/v1/wiki

APIのベースURLは次のとおりです：https://ihre-firma.kibi.de/api/v1

すべてのエンドポイントとパラメーターを含む完全なAPIドキュメントは、Kibi Connect内で直接利用できます：

主なエンドポイントの概要：

作成されたすべてのトークンは、ユーザープロフィール → 統合の概要に表示されます。ここで以下を確認できます：