Garoon REST APIリクエストを送信する
Garoon REST APIで利用できます。
- 本APIは非同期リクエストとなります。同期的に処理したい場合はこちらのTipsをご参照ください。
関数
garoon.api(pathOrUrl, method, params, callback, opt_errback)
使用可能なガルーンバージョン
- クラウド版 Garoon
- パッケージ版 Garoon バージョン 5.0.0以降
引数
| パラメータ名 | 指定する値 | 必須 | 説明 |
|---|---|---|---|
| pathOrUrl | 文字列 | 必須 | Garoon REST APIのパスを指定します。 例）API のURLが https://(サブドメイン名).cybozu.com/g/api/v1/xxx の場合は、そのまま記載するか、"/api/v1/xxx" を指定します。 |
| method | 文字列 | 必須 | 使用するHTTPメソッド。 GET,POST,PATCH,DELETE,PUTが指定可能です。 |
| params | オブジェクト | 必須 | APIに渡すパラメータをオブジェクトで指定します。 省略する場合は、"{}"を指定します。 |
| callback | 関数 | 省略可 |
APIの呼び出しが成功したら実行されるコールバック関数です。 |
| opt_errback | 関数 | 省略可 |
APIの呼び出しが失敗したら実行されるコールバック関数です。 |
この関数を使用してGaroon REST APIを実行する場合、HTTPメソッドに関わらずCSRFトークンが不要となります。
CSRFトークン利用の詳細については、Garoon CSRFトークン利用例を確認ください。
返り値
引数のcallbackを省略した場合、garoon.Promiseオブジェクトを返します。
callbackを指定した場合、返り値はありません。（nullが返されます）
利用できる画面
- 全ての画面（ポップアップ画面を除く）
サンプル
コールバックを使用した記述方法
garoon.Promiseオブジェクトを使った記述方法
この関数を使用してGaroonから User API は実行できないのでしょうか？
kintone側で同じ位置づけと思われる「kintone.api()」では実行できた為、少しモヤっとしました。
Garoon側で User API を実行する際は xmlHttpRequest() を使用する想定でしょうか？
（xmlHttpRequestによる実行は確認できました。）
naoki watanabe 様
お世話になっております。cybozu developer network 運営局です。
garoon.api() を使って User API を実行することはできません。
kintone.api() とは使用感が違うというご意見は、Garoon 開発チームにフィードバックさせていただきます。
Garoon から User API を利用するには、ご記載の通り、XMLHttpRequest や、 jQuery.ajax() や Axios などHTTP リクエストを送るライブラリを利用するか、または Garoon JavaScript API ですと garoon.base.proxy.send() を使って実行することを想定しております。
参照：Garoon カスタマイズで外部システムの API を実行する〜打合せコスト算出カスタマイズ〜
よろしくお願いいたします。