APIリクエスト実行・機能一覧

Reckoner APIで提供している機能と、各リクエストの実行例（curl）は以下の通りです。

APIリクエストの注意点
●認証方法：APIの認証には、HTTPヘッダーに Authorization: Bearer <発行したトークン> を含めてリクエストを送信してください。
●Windows環境での実行：Windows環境（PowerShell等）で実行する場合は、コマンドの curl を curl.exe に書き換えて実行してください。

ワークフロー操作・管理

接続情報の管理

プロジェクトの管理

アカウント管理

認証・トークン管理

APIトークンの発行

APIの利用には、認証用の「APIトークン（専用の鍵）」が必要です。以下の手順で発行してください。

1. Reckonerにログインし、[設定] を選択します。
   

2. [ReckonerAPI設定] を選択します。
   

3. [ReckonerAPIトークンの新規作成] をクリックします。

4. 設定ダイアログに任意の「トークン名」を入力し、「トークン種別」を選択して[作成]をクリックします。
   

5. 表示されたトークンをコピーし、安全な場所に保管してください。
   アクセストークンのみの場合に表示される画面
   
   アクセストークン＋リフレッシュトークンの場合に表示される画面
   

※トークンの権限とセキュリティ
　トークンは一度画面を閉じると再表示できません。
　トークンの操作権限（参照可能なプロジェクト等）は、発行したユーザーアカウントの権限に準じます。

トークンの管理

発行済みのトークンは、ReckonerAPI設定画面での確認や、ReckonerAPI経由での自動更新が可能です。トークンを無効化（削除）する場合は、対象トークンの右側にある横三点リーダーをクリックし、「トークンを無効にする」を選択してください。

閲覧権限: チーム内で発行されたトークン一覧は、チーム管理者権限を持つユーザーのみが確認できます。
無効化: トークンの漏洩が疑われる場合や、利用を終了する場合は、速やかに当該トークンを無効化してください。

【重要】トークンの失効について
APIトークンは発行したユーザーアカウントに紐付いています。 そのため、そのユーザーがプロジェクトから削除されたり、Reckonerのアカウント自体が削除（退職等）されたりすると、該当ユーザーが発行したすべてのトークンも自動的に無効化（削除）されます。システム連携等で継続的にトークンを利用している場合は、ユーザー削除の前に、別の有効なユーザーアカウントでトークンを再発行し、差し替えを行うようご注意ください。

アクセストークンおよびリフレッシュトークンの有効期限については、こちらをご参照ください。
Reckoner APIのレートリミット（実行制限）については、こちらをご確認ください。

各種ID・名称の確認方法

APIリクエストに必要な各値は、以下の方法で確認できます。

• プロジェクトID：
  [プロジェクト設定] 画面のURL末尾の数字。（例：.../projects/66 → 66）または、「プロジェクト一覧」APIで確認できます。
• ワークフローID：
  [ワークフロー一覧] 画面で対象を選択した際のURL末尾の数字。または「ワークフロー一覧取得」APIで確認できます。
• ジョブID：
   [ワークフロー一覧] 画面で対象を選択し、[実行履歴]タブから特定の実行履歴を表示した際のURL末尾の数字。または「ワークフロー実行」APIのレスポンスから確認できます。
• サービス名（コネクタ名）：
  [接続情報] 画面で対象のコネクタを選択した際のURL末尾の文字列。（例：.../integrations/excel → excel）
• インテグレーションID（integration_id）：
  「接続情報取得」APIのレスポンス内にある integration_id の値。

APIリファレンス

パラメータやレスポンスの詳細は、APIリファレンス をご参照ください。

関連記事

• Reckoner APIのアクセストークンおよびリフレッシュトークンの有効期限について
• Reckoner APIのレートリミット（実行制限）について