サーバーサイドオープンAPI

宜搭プラットフォームは、クライアントサイドで呼び出すためのオープンAPIに加えて、サーバーサイドから呼び出すことをサポートするオープンAPIも提供しており、詳細は钉钉オープンプラットフォームドキュメントを参照してください。

ご利用ガイド

宜搭プラットフォームのサーバーサイドオープンAPIを使用する手順は以下の通りです：

ヒント

钉钉オープンプラットフォームは複数のアプリケーションタイプを提供しており、アプリケーションタイプごとにサーバーサイドオープンAPIの使用方法が異なります。詳細は钉钉アプリケーションタイプ紹介ドキュメントを参照してください。

ステップ1：钉钉アプリケーションの作成

• 企業内アプリケーションを作成する場合の詳細は、企業内アプリケーション開発プロセス紹介を参照してください。
• サードパーティ企業アプリケーションを作成する場合の詳細は、サードパーティ企業アプリケーション説明を参照してください。

ステップ2：インターフェース呼び出し権限の追加

アプリケーション作成後、デフォルトではログインおよびメッセージ通知インターフェースの呼び出し権限のみが開放されており、開発の必要に応じて、対応するインターフェース使用権限を追加する必要があります。

• 企業内アプリケーションの場合、詳細はインターフェース呼び出し権限の追加を参照してください。
• サードパーティ企業アプリケーションの場合、詳細はインターフェース呼び出し権限の追加を参照してください。

ステップ3：アプリケーションのaccess_tokenの取得

access_tokenはいわば身分証のようなものです。インターフェースを呼び出す際、access_tokenを使用して呼び出し者の身分を認証します。

• 企業内アプリケーションの場合は、企業内アプリケーションのaccessTokenの取得を参照してください。
• サードパーティアプリケーションの場合は、サードパーティアプリケーションで認可された企業のaccessTokenの取得を参照してください。

APIリスト

フロー

インターフェース説明	企業内アプリケーション	サードパーティ企業アプリケーション	サードパーティ個人アプリケーション	権限
宜搭承認フローの開始	サポート	サポート	未対応	宜搭フローデータ書き込み権限
フロインスタンスの削除	サポート	サポート	未対応	宜搭フローデータ書き込み権限
フロインスタンスの終了	サポート	サポート	未対応	宜搭フローデータ書き込み権限

フォーム

インターフェース説明	企業内アプリケーション	サードパーティ企業アプリケーション	サードパーティ個人アプリケーション	権限
フォームインスタンスデータの照会	サポート	サポート	未対応	宜搭フォームデータ読み取り権限
フォームデータの保存	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
フォームデータの更新	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
フォームデータの照会	サポート	サポート	未対応	宜搭フォームデータ読み取り権限
従業員コンポーネントの値の取得	サポート	サポート	未対応	宜搭フォームデータ読み取り権限
フォームコンポーネント定義リストの取得	サポート	サポート	未対応	宜搭フォームデータ読み取り権限
子テーブルコンポーネントデータの取得	サポート	サポート	未対応	宜搭フォームデータ読み取り権限
フォームデータの削除	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
複数フォームインスタンスIDの取得	サポート	サポート	未対応	宜搭フォームデータ読み取り権限
複数フォームインスタンスデータの一括取得	サポート	サポート	未対応	宜搭フォームデータ読み取り権限
複数フォームインスタンスの一括削除	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
複数フォームインスタンスの一括作成	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
フォームインスタンス内のコンポーネント値の一括更新	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
フォームインスタンスの新規作成または更新	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
上級クエリ条件でフォームインスタンスデータを取得（サブフォームコンポーネントデータを含む）	サポート	サポート	未対応	宜搭フォームデータ読み取り権限
上級クエリ条件でフォームインスタンスデータを取得（サブフォームコンポーネントデータを含まない）	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
フォームインスタンスデータで複数フォームインスタンスを一括更新	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
フォームの変更記録の照会	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
フロー設計構造の取得	サポート	サポート	未対応	宜搭フォームデータ書き込み権限
コンポーネントエイリアスリストの取得	サポート	サポート	未対応	宜搭フォームデータ書き込み権限

タスク

インターフェース説明	企業内アプリケーション	サードパーティ企業アプリケーション	サードパーティ個人アプリケーション	権限
承認記録の取得	サポート	サポート	未対応	宜搭フローデータ読み取り権限
宜搭承認タスクの承認または拒否	サポート	サポート	未対応	宜搭フローデータ書き込み権限
組織内の誰かが提出したタスクの取得	サポート	サポート	未対応	宜搭フローデータ読み取り権限
組織内で完了した承認タスクの取得	サポート	サポート	未対応	宜搭タスク読み取り権限
タスクの譲渡	サポート	サポート	未対応	宜搭タスク書き込み権限
フロー実行タスク（VPC）の照会	サポート	サポート	未対応	宜搭タスク読み取り権限
タスクリストの取得（組織次元）	サポート	サポート	未対応	宜搭タスク読み取り権限
ユーザーに送信された通知の取得	サポート	サポート	未対応	宜搭タスク読み取り権限
自分にCCされたタスクリストの照会（アプリケーション次元）	サポート	サポート	未対応	宜搭タスク読み取り権限
コメントの投稿	サポート	サポート	未対応	宜搭コメント書き込み権限
宜搭承認タスクの一括実行	サポート	サポート	未対応	宜搭コメント書き込み権限
宜搭フォームインスタンスのコメント一括照会	サポート	サポート	未対応	宜搭コメント書き込み権限

添付ファイル

インターフェース説明	企業内アプリケーション	サードパーティ企業アプリケーション	サードパーティ個人アプリケーション	権限
宜搭添付ファイル一時無認証アドレスの取得	サポート	サポート	未対応	宜搭フローデータ読み取り権限