外部 API の実行に必要な情報をプラグインへ保存する

目次

外部 API の実行に必要な情報をプラグインへ保存する

外部の API を実行するときに必要な情報を、プラグインに保存します。
この API を使って保存された情報は、 プラグインから外部 API を実行する API を実行したときに、リクエストのヘッダーとボディに追加されます。

認証情報など、秘匿する情報を外部 API の実行で使用する場合は、この API を使って必要な情報をあらかじめプラグインに保存します。

この API は、アプリの管理者だけがアクセスできるプラグイン設定画面でのみ実行できます。
そのため、アプリの利用者がプラグインへ保存された情報にアクセスすることを防げます。

関数

PC/モバイル

kintone.plugin.app.setProxyConfig(url, method, headers, data, successCallback)

引数

指定した URL と HTTP メソッドの組み合わせがすでに存在している場合は、プラグインの設定が上書きされます。

引数 必須 説明
url 文字列 必須 実行する API の URL
method 文字列 必須 HTTP メソッド
次のいずれかの値を指定します。
  • GET
  • POST
  • PUT
  • DELETE
headers オブジェクト 必須 API のリクエストヘッダーに加えるパラメーター
指定したパラメーターが、 プラグインから外部 API を実行する API で指定したパラメーターと重複する場合、この API で指定したパラメーターが優先されます。
何も指定しない場合は、空のオブジェクトを指定します。
data オブジェクト 必須 API のリクエストデータに加えるリクエストボディ
例:
{
"key1": "value1",
"key2": "value2"
}
指定したキーが、 プラグインから外部 API を実行する API で指定したボディのキーと重複する場合、この API で指定したキーの値が優先されます。
何も指定しない場合は、空のオブジェクトを指定します。
successCallback 関数 省略可 外部 API のリクエスト情報の保存が完了したときに実行されるコールバック関数
引数はありません。
successCallback を省略する、または「undefined」か 「null」を指定している場合、アプリ設定のプラグインの一覧画面に遷移し、設定完了メッセージを表示します。
successCallback を指定すると、アプリ設定のプラグインの一覧画面には遷移しません。

戻り値

なし

利用できる画面

PC
  • 各プラグインの設定画面
モバイル

なし

補足

保存した情報がリクエストに追加される条件
  • プラグインから外部 API を実行する API を使ったリクエストでは、次の条件をすべて満たすときに、プラグインへ保存した情報がリクエストに追加されます。

    • アプリが同一
    • プラグインが同一
    • HTTP メソッドが同一
    • 実行する API の URL が前方一致する *1
      URL の大文字と小文字は区別されます。
  • プラグインに複数の設定を保存した場合は、API の実行時に指定した URL と、より多くの文字が一致する URL を指定している設定が優先されます。
    たとえば、この API で、次のような URL やリクエストヘッダーを指定したとします。

    • 設定その 1
      • URL:https://api.example.com/
      • ヘッダー:{ "Content-Type": "application/x-www-form-urlencoded" }
    • 設定その 2
      • URL:https://api.example.com/foo/
      • ヘッダー:{ "Content-Type": "application/json" }

    次の値を指定して、 プラグインから外部 API を実行する API を実行します。

    • URL:「https://api.example.com/foo/operate.json」
    • ヘッダー:{}

    このとき、API の実行時に送信されるリクエストのヘッダーは、{ "Content-Type": "application/json" } です。

*1

たとえば、それぞれの関数で次の URL を指定した場合には、URL が前方一致するため、プラグインへ保存した情報がリクエストに加わります。

^