コンテンツにスキップ
Documentation

サービスエンドポイントのリファレンス

このページ上のすべてのパスは、以下を基準としています:

https://api.champrep.com

「認証とAPIキー」に記載されているとおり、スコープ付きベアラークレデンシャルを使用してください。リストされているルートであっても、現在のサービスの可用性、プランおよび組織の設定、ロールの権限、リソースへのアクセス、およびリアルタイムの使用状況制御の対象となります。サービスマップ 認証と API キーAPI。掲載されているルートは、 現在のサービスの可用性、プランおよび組織の設定、ロールの 権限、リソースへのアクセス、およびリアルタイムの使用状況制御の影響を受けます。

エリアプレフィックススコープ
ID およびプロフィール/v1/auth, /v1/usersusers:read および認証情報のコンテキスト
サービス横断検索/v1/search検索対象となる各サービスの読み取り範囲
Drive/v1/drivedrive:read, drive:write, drive:delete
Chat/v1/chatchat:read, chat:write
Calendar/v1/calendarcalendar:read, calendar:write
Contacts/v1/contactscontacts:read, contacts:write
Meet/v1/meetmeet:read, meet:write
Notes/v1/notesnotes:read, notes:write
Sheets/v1/sheetssheets:read, sheets:write, sheets:share, sheets:delete, sheets:export
Docs/passthrough/docsdocs:read, docs:write, docs:share, docs:delete, docs:export
Learn/v1/learn, /v1/coursescourses:read, courses:write
CHAMPREP AI/v1/aiai:chat
Mail/v1/mailmail:read, mail:write, mail:send
Work/v1/workwork:read, work:write, work:delete
Org Chart/v1/chartscharts:read, charts:write, charts:delete
Forms/v1/formsforms:read, forms:write
Invoice/v1/invoiceinvoice:read, invoice:write, invoice:send, invoice:delete
CHAMPREP QA/v1/qaqa:read, qa:write
CHAMPREP Code/passthrough/codecode: スコープについては、以下を参照してください。 CHAMPREP コード
ランナーファーム/passthrough/runner-farmrunner_farm:read, runner_farm:write
CHAMPREP Business/v1/businessbusiness:read, business:manage
請求/v1/billingbilling:read, billing:manage
Webhook/v1/webhookswebhooks:manage

GET, HEAD、および OPTIONS 通常、読み取りスコープが必要です。作成、更新、 およびアクションメソッドには、書き込みまたは管理スコープが必要です。削除メソッドには、 サービスで定義されている場合、削除スコープが必要です。ルートによっては、宛先サービスにおいて追加の ロールまたはリソースの権限が必要となる場合があります。

方法パス目的
GET/v1/versionGatewayの公開バージョン情報を返します。
GET/v1/auth/whoamiアクティブなユーザー、プロフィール、認証情報、およびプランのコンテキストを取得します。
GET/v1/auth/quota現在のキーおよびゲートウェイのクォータのスナップショットを取得します。
GET/v1/users/me現在のユーザーのプロフィールを取得します。
GET/v1/users/me/notifications現在のユーザーが確認できる通知を一覧表示します。

ブラウザを利用したデータCLI交換では、以下の機能も使用されます。 /v1/auth/cli/start, /v1/auth/cli/device、および /v1/auth/cli/poll。これらのルートは 公式の によって実装されていますCLI。カスタムアプリケーションは、 キーAPIで要件が満たされる場合、CLI承認プロトコルを模倣すべきではありません。

方法パススコープ目的
GET/v1/searchサービスごとの詳細については、以下をご覧ください。この認証情報でアクセス可能なすべてのサービスを、1回の呼び出しで検索してください。
GET/v1/search/servicesなしこの認証情報で検索可能なサービスをリストアップしてください。

/v1/search 検索をサポートする各サービスにリクエストを分散させ、 結果を統合します。パラメータ:

パラメータデフォルト目的
q必須検索語句。
limit5サービスごとの最大結果数は、最大 20.
servicesすべてカンマ区切りのリストの例: mail,drive。これにより、ファンアウトを絞り込むことができます。
semanticfalse設定 true AIを使用して検索結果の順位を再調整し、簡潔な回答を取得します。ご自身のAIクレジットが消費されます。

semantic=true すでに表示されている検索結果の上にAIパスを追加します。AIパスは 質問を読み取り、その回答の適切さに応じて一致する結果を並べ替え、それぞれに簡潔な理由を 付加し、1段落分の answer.

この機能は、ご自身のAIクレジットで支払われます — これはアシスタントが CHAMPREP AI使用するのと同じ月間割り当て分です。ご自身でリクエストしない限り課金されることはなく、 キーワード検索にはAIクレジットは一切消費されません。

すべての応答では、何が起きたかが以下のように報告されます: semantic:

"semantic": { "requested": true, "applied": true, "answer": "..." }

AIパスが実行できない場合、キーワードによる検索結果は変更されずに返され、 semantic 理由の説明:

reason意味
AI_CREDITS_EXHAUSTED今月のAIクレジットを使い切りました。
PLAN_NO_AIご利用のプランにはAIサービスが含まれていません。
AI_UNAVAILABLE今回、AIサービスに接続できませんでした。

AIパスが失敗しても、検索自体が失敗することはありません。お電話にて /v1/search/services まず、 スマート検索が利用可能かどうかをご確認ください。スマート検索では semantic.available さらに、 残りのクレジットも表示されます。利用できない場合は、AIオプションを非表示にしてください。

サービスは、その認証情報に読み取りスコープが含まれている場合にのみ対象となります (mail:read, drive:read, notes:read, calendar:read, chat:read, work:read, invoice:read, contacts:read) そして 有効なプランで許可されている場合に限ります。 どちらのチェックも失敗した場合はクローズされるため、利用できないサービスは結果に含まれることはありません。

Chat メッセージは保存時に暗号化され、検索はあなたが 所属するルーム内でのみ行われ、アーカイブ全体ではなく最近の履歴を対象とします。

Terminal window
curl -H "Authorization: Bearer $CHAMPREP_API_KEY" \
"https://api.champrep.com/v1/search?q=roadmap&services=mail,notes&limit=3"

結果はサービスごとにグループ化され、統一された形式に正規化されるため、クライアントは すべてのサービスを同じ方法でレンダリングします:

{
"success": true,
"data": {
"query": "roadmap",
"groups": [
{
"service": "notes",
"label": "Notes",
"results": [
{ "id": "6650...", "title": "Q3 roadmap", "subtitle": "Planning notes for...", "timestamp": "2026-08-02T10:14:00Z" }
]
}
],
"totalResults": 1,
"searched": ["notes", "mail"],
"skipped": [{ "service": "drive", "reason": "INSUFFICIENT_SCOPE" }],
"cost": 2
}
}

続きを読む skipped 空の結果を「何も見つかりませんでした」とみなす前に、各エントリには そのサービスが除外された理由が説明されています — INSUFFICIENT_SCOPE, NOT_IN_PLAN、または SERVICE_UNAVAILABLE バックエンドの応答が遅すぎたり、一時的に接続できない場合などです。1つの サービスが利用できないからといって、クエリ全体が失敗することはありません。残りの結果は 引き続き返されます。

検索は結果グループごとに1つのサービスに到達するため、そのように課金されます: 実際に検索されたサービスごとに 1つのレート制限単位。 cost 各 レスポンスのフィールドには、正確にどのような課金が行われたかが示されており、 X-RateLimit-Remaining レスポンスを受け取る前に反映されます。

リクエスト検索されたサービス費用
?q=roadmap 8つすべてを含むプランの場合88
?q=roadmap&services=mail11
?q=roadmap のみを含むプランの場合 Notes11

利用できないサービスに対しては課金されることはありませんので、絞り込みを行うことで services は、対話型検索の応答性を維持するための最もコスト効率の良い方法です。常に デバウンスを行ってください。キー入力ごとにリクエストを送信することは避けてください。

方法パススコープ目的
GET/v1/drive/filesdrive:readファイルの一覧表示または検索を行います。以下の search 必要に応じてクエリを実行します。
GET/v1/drive/foldersdrive:readルートフォルダの内容を一覧表示します。
GET/v1/drive/folders/{folderId}drive:readフォルダの内容を一覧表示します。
GET/v1/drive/starreddrive:readスター付きアイテムを一覧表示します。
GET/v1/drive/recentdrive:read最近使用した項目を一覧表示します。
GET/v1/drive/shareddrive:read共有アイテムを一覧表示します。
GET/v1/drive/quotadrive:read現在のストレージ使用量と空き容量を取得します。
POST/v1/drive/uploaddrive:writeアップロード先を作成します。
POST/v1/drive/filesdrive:writeアップロードが成功した後、ファイルのメタデータを保存します。
POST/v1/drive/downloaddrive:read呼び出し元の認証情報に紐づけられた、有効期間が短いダウンロードリンクを作成します。
GET/v1/drive/content/{token}drive:readによって発行されたリンクをストリーム配信します。 /v1/drive/download.
POST/v1/drive/foldersdrive:writeフォルダを作成します。
POST/v1/drive/renamedrive:writeアイテムを移動または名前変更します。
POST/v1/drive/deletedrive:delete1つまたは複数の項目を削除します。
DELETE/v1/drive/files/{fileId}drive:delete従来の単一アイテム処理手順でファイルを削除します。

ダウンロードには2つの手順があります: POST /v1/drive/download は url on the gateway that works only for the APIkey or session that requested it, until expiresInSeconds が期限切れになるまで有効です。同じヘッダーを使用して取得してください。このリンクは単独では使用できません。 Authorization ヘッダーを指定して取得してください。この リンクは単独では使用できません。

アップロードは複数のステップからなる操作です。アップロード先を指定し、その先にデータを転送し、 その結果として生成されたメタデータを保存します。この一連の処理を ご自身で実装する必要がない場合はCLI、 をご利用ください。

方法パススコープ目的
GET/v1/chat/roomschat:readアクティブなプロフィールから閲覧可能な会議室を一覧表示します。
GET/v1/chat/rooms/{roomId}chat:read1つのルームを読み取ります。
POST/v1/chat/roomschat:writeルームを作成します。
GET/v1/chat/rooms/{roomId}/messageschat:readルームのメッセージを一覧表示します。
POST/v1/chat/rooms/{roomId}/messageschat:writeルームメッセージを送信します。
GET/v1/chat/messages/searchchat:readメッセージを検索します。
GET/v1/chat/unreadchat:read未読件数を返します。
GET/v1/chat/favoriteschat:readお気に入りのメッセージを一覧表示します。
方法パススコープ目的
GET/v1/calendar/eventscalendar:readイベントの一覧表示;以下に対応しています startDate および endDate クエリ。
GET/v1/calendar/events/{eventId}calendar:read1つの予定を読み取ります。
POST/v1/calendar/eventscalendar:writeイベントを作成します。
PATCH/v1/calendar/events/{eventId}calendar:writeイベントを更新します。
DELETE/v1/calendar/events/{eventId}calendar:writeイベントを削除します。
GET/v1/calendar/upcomingcalendar:read今後の会議を一覧表示します。
GET/v1/calendar/invitationscalendar:read保留中の招待状を一覧表示します。

イベントのタイムスタンプは、明示的なタイムゾーンを指定したISO 8601形式で送信されます。イベントの 作成および更新には、アクティブなプランおよび 組織に設定されたクォータが消費されます。このサービスでは、プランごとの一律の固定制限は定義されてAPIいません。

方法パススコープ目的
GET/v1/contactscontacts:read連絡先を一覧表示します。
GET/v1/contacts/searchcontacts:readで連絡先を検索します。 q または email.
GET/v1/contacts/favoritescontacts:readお気に入りを一覧表示します。
GET/v1/contacts/labelscontacts:readラベルを一覧表示します。
GET/v1/contacts/{contactId}contacts:read1件の連絡先を読み取ります。
POST/v1/contactscontacts:write連絡先を追加します。
PUT/v1/contacts/{contactId}contacts:write連絡先のメタデータを更新します。
DELETE/v1/contacts/{contactId}contacts:write連絡先を削除します。
方法パススコープ目的
GET/v1/meet/roomsmeet:read会議室を一覧表示します。
GET/v1/meet/rooms/{roomId}meet:read1つのルームを読み取ります。
POST/v1/meet/roomsmeet:writeルームを作成します。
GET/v1/meet/sessionsmeet:readミーティングのセッションを一覧表示します。
GET/v1/meet/sessions/{sessionId}/participantsmeet:readセッションの参加者を一覧表示します。
GET/v1/meet/recordingsmeet:read利用可能な録画を一覧表示します。
GET/v1/meet/transcriptionsmeet:read文字起こしを一覧表示します。
GET/v1/meet/transcriptions/{sessionId}meet:read最終セッションの文字起こしを読み取ります。
GET/v1/meet/usagemeet:read現在のミーティングの利用状況を返します。

録音および文字起こしへのアクセスは、会議の所有権、同意、 保存期間、プラン、および組織のポリシーによって異なります。

方法パススコープ目的
GET/v1/notesnotes:readノートを一覧表示します。
GET/v1/notes/sharednotes:readアクティブなプロフィールと共有されているノートを一覧表示します。
GET/v1/notes/{noteId}notes:read1つのノートを読み取ります。
POST/v1/notesnotes:writeメモを作成します。
PATCH/v1/notes/{noteId}notes:writeノートを更新します。
DELETE/v1/notes/{noteId}notes:writeメモを削除します。
POST/v1/notes/{noteId}/sharenotes:writeサポートされているアクセス設定を使用して、ノートを共有します。

/v1/learn および /v1/courses 同じ厳選されたコースのルートを公開します。

方法パススコープ目的
GET/v1/learncourses:read利用可能なコースを一覧表示します。
GET/v1/learn/enrolled/mycourses:readアクティブなユーザーの受講登録を一覧表示します。
GET/v1/learn/{courseId}courses:read1つのコースを読み取ります。
GET/v1/learn/{courseId}/sectionscourses:readコースのセクションを一覧表示します。
POST/v1/learncourses:writeロールで許可されている場合、コースを作成します。
PUT/v1/learn/{courseId}courses:writeロールで許可されている場合、コースを更新します。

以下の /v1/courses そのエイリアスをすでに使用している統合を維持する場合は、 代わりにプレフィックスを使用してください。

方法パススコープ目的
POST/v1/ai/chatai:chatプロンプトまたはサポートされている会話ペイロードを送信します。
GET/v1/ai/conversationsai:chat保存された会話の一覧を表示します。
GET/v1/ai/conversations/{conversationId}ai:chat1つの会話を読み取ります。
DELETE/v1/ai/conversations/{conversationId}ai:chat会話を削除します。
GET/v1/ai/usageai:chat現在の AI の使用状況を返します。

AIの出力は不完全または不正確な場合があります。重要な出力内容は確認し、 アクティブなユーザーが開示する権限を持たないデータを送信しないでください。

方法パススコープ目的
GET/v1/mail/accountsmail:read接続済みのメールアカウントを一覧表示します。
GET/v1/mail/emailsmail:readメッセージを一覧表示します。
GET/v1/mail/emails/{emailId}mail:read1 つのメッセージを読み取ります。
GET/v1/mail/threadsmail:readスレッドを一覧表示します。
GET/v1/mail/threads/{threadId}mail:read1つのスレッドを読み取ります。
POST/v1/mail/sendmail:sendメッセージを送信します。
GET/v1/mail/domainsmail:read表示可能なメールドメインを一覧表示します。

「GatewayWork」サーフェスは、以下のサポート対象のバージョン管理された WorkAPIを反映しています。 /v1/work。ゲートウェイは、HTTPメソッドから必要なスコープを判別します:

  • 読み取りメソッドには work:read.
  • `create` および `update` メソッドには “ が必要です。 work:write.
  • 削除メソッド、および破壊的な一括処理やインポートのキャンセル操作には、 work:delete.

一般的なルートには以下が含まれます:

方法パス目的
GET, POST/v1/work/boardsボードを一覧表示または作成します。
GET, PUT, DELETE/v1/work/boards/{boardId}ボードの読み取り、更新、またはアーカイブを行います。
GET/v1/work/boards/{boardId}/kanbanボードのカンバンビューを読み取ります。
GET/v1/work/boards/{boardId}/export/csvボードをCSV形式でエクスポートします。
GET/v1/work/boards/{boardId}/export/json構造化されたボードのスナップショットをエクスポートします。
GET, POST/v1/work/ticketsチケットを検索または作成します。
GET, PUT, DELETE/v1/work/tickets/{ticketId}チケットの読み取り、更新、またはアーカイブを行います。
GET/v1/work/me/dashboardアクティブなダッシュボードWorkの概要を取得します。
GET/v1/work/me/quota現在の の使用Work状況と制限を返します。
GET, POST/v1/work/import/jobsサポートされているインポートジョブを一覧表示または管理します。

ボード、チケット、スプリント、自動化、インポート、時間記録、コメント、 添付ファイル、保存済みビュー、およびワークスペースのメンバーシップについては、Gatewayのスコープチェック後も、それぞれのWork ロールおよびリソース権限が引き続き適用されます。

「」サーフェOrg Chartスは、以下の下に利用可能です。 /v1/charts。読み取りメソッドには以下が必要です charts:read、作成および更新メソッドには以下が必要です charts:write、および削除 メソッドには以下が必要です charts:delete.

一般的なルートには以下が含まれます:

方法パス目的
GET/v1/charts/me/org-chartアクティブなユーザーのチャートを読み取ります。
GET/v1/charts/me/positionアクティブなチャートの位置を確認してください。
GET/v1/charts/me/connections関係接続の読み取り。
GET/v1/charts/me/suggestions関係性の提案を確認してください。
GET/v1/charts/users/searchユーザーを検索して、チャートの関連性を確認してください。
GET/v1/charts/orgs/{orgId}/chart組織図を読み取ります。
PATCH/v1/charts/orgs/{orgId}/configチャート設定を更新します。
POST/v1/charts/orgs/{orgId}/chart/nodesチャートノードを作成します。
PATCH, DELETE/v1/charts/orgs/{orgId}/chart/nodes/{nodeId}ノードを更新または削除します。

拡張サービスインターフェース

Section titled “拡張サービスインターフェース”

また、Gateway では以下のバージョン管理されたサービスプレフィックスも公開されています:

プレフィックス読み取りスコープ書き込みまたはアクションのスコープスコープの削除
/v1/formsforms:readforms:write—
/v1/sheetssheets:read; エクスポート操作では以下を使用します sheets:exportsheets:write; 共有および公開には以下を使用します sheets:sharesheets:delete
/v1/invoiceinvoice:readinvoice:write; アクションの送信または発行には以下を使用します invoice:sendinvoice:delete
/v1/qaqa:readqa:write—
/v1/businessbusiness:readbusiness:manage—
/v1/billingbilling:readbilling:manage—

これらのプレフィックスは、Gatewayの下でサポートされているリソースサフィックスを維持しつつ、 認証、サービスへのアクセス、スコープ、レート制限、および監査 コンテキストを一元化します。ブラウザのトラフィックからリソースパスを推測するのではなく、 サービスによって明示的に公開されているルートを使用することを推奨します。

課金はコントロールプレーンのインターフェースです。宛先サービスのゲートウェイによって ユーザーが支払いの修正やアップグレードを行えなくなった場合でも、 API Gatewayアクセス、 レート制限、および課金スコープの対象となります。

CHAMPREP Code、Runner Farm、および Docs にはパススルーを介してアクセスします。 Gateway は、他のすべてのルートと同様に、キー、レート制限、プラン、およびスコープのチェックを行った後、 リクエストを固定の パスAPIで、そのサービス独自の REST パスに転送します。プレフィックス以降のパスは、サービス独自のパスAPIとなります。

プレフィックス転送例
/passthrough/codeCHAMPREP Code の下のパスAPI /v1/codeGET /passthrough/code/v1/code/projects
/passthrough/runner-farmRunner Farm の配下のパスAPI /v1GET /passthrough/runner-farm/v1/pools
/passthrough/docsDocs 配下のAPIパス /api/v1/docsGET /passthrough/docs/api/v1/docs/documents

許可された名前空間外のパスは、 404 NOT_FOUND。 Gateway独自の認証情報のみがサービスにアクセスできます。 ヘッダーや job_token, private_token、または access_token クエリ パラメータは、Gateway によって削除されるため、指定しないでください。

  • GET, HEAD、および OPTIONS 少なくとも1つの code: 読み取り可能なスコープが必要です。 その他のメソッドには code:api または code:write_ スコープ。
  • CHAMPREP Codeはその後、各エンドポイントの正確なスコープを、 個人用アクセストークンを確認するのと同じ方法でチェックします。例えば、リポジトリファイルの読み取りには code:read_repository, code:read_api、または code:api.
  • 以下のパス /v1/code/admin には、を保持するキーが必要です code:admin_mode によって 名前で指定されたキー、および Code 管理者であるアカウントが必要です。ワイルドカードや code:api はこれらにアクセスできません。

  • 読み取りメソッドには が必要です runner_farm:read。その他のメソッドには runner_farm:write.
  • キーは、コネクタのシークレット、ランナー・トークン、トークンチェック、 ペアリング、またはコネクタ独自のエンドポイントには決してアクセスできず、クレジットの購入や 支払い設定の変更も一切行いません。それらを行うには、ログインした状態で「ランナー・ファーム」アプリをご利用ください。
リクエストスコープ
GET, HEADdocs:read
権限の付与、共有リンク、または公開を管理するパスdocs:share
DELETE、またはで終わるパス /purgedocs:delete
で終わるパス /exportdocs:export
その他の変更ドキュメント内の画像を削除することは通常の編集操作であり、が必要です。docs:write

ドキュメント内の画像を削除することは通常の編集であり、が必要です。 docs:write.

Webhook管理では以下を使用します /v1/webhooks および webhooks:manage。詳細は、専用の Webhookガイド エンドポイントの登録、署名付き配信の 検証、リプレイ保護、およびシークレットのローテーションについては、専用のWebhookガイドをご参照ください。

  • 使用 GET /v1/version Gatewayのバージョン情報については、こちらをご参照ください。
  • クライアントが認識できない追加のレスポンスフィールドは無視してください。
  • プランの値をハードコーディングするのではなく、リアルタイムのリミットヘッダーを読み取ってください。
  • 最小権限のスコープセットを使用してください。
  • 新しいルートを採用する際は、ドキュメントサイトのリリースノートに従ってください。