APIへの接続
REST、GraphQLまたはSOAP APIに接続します。
HTTP、GraphQLまたはSOAP APIへのリクエストをRetoolで実行できます。多数の開発者は、独自の内部APIからデータを取得し、Table
にデータを表示してからデータ(パスワードのリセットなど)を独自のAPIにpost
します。しかし、Stripe、Salesforce、SlackなどのAPIにRetoolを接続することもできます。
URLパラメーター、ヘッダーおよびCookieを設定できるインターフェイスで、RESTリソースにクエリーを実行します。
![Screen Shot 2018-08-09 at 11.37.18 AM.png 2646](https://files.readme.io/9b4de85-Screen_Shot_2018-08-09_at_11.37.18_AM.png)
httpbinへのPOST
認証に関するヘルプが必要な場合は、認証のガイドを参照してください。
ビデオ: RetoolにAPIを接続する
APIをRetoolに接続する基本についてのビデオ・ウォークスルーを用意しました(こちら( English ))。
APIリクエストのJSON本体
デフォルトでは、キー/値インターフェイスを使用して、JSONオブジェクトを容易に構築できます。さらに複雑な構造を作成するには、次のように、キーの子としてオブジェクトをネストできます。
![Screen Shot 2018-05-09 at 1.03.07 PM.png 1466](https://files.readme.io/08bb44f-Screen_Shot_2018-05-09_at_1.03.07_PM.png)
別の方法として、キー/値インターフェイスから切り替えて、カスタムJSONを送信することもできます。以下に、上記と同等のクエリーを示します。これが機能するには、Content-Type
ヘッダーを指定する必要があります。
![Screen Shot 2018-05-09 at 1.07.14 PM.png 1454](https://files.readme.io/29b9351-Screen_Shot_2018-05-09_at_1.07.14_PM.png)
JSONの書式設定は、最初は少し分かりにくいかもしれません
文字列である値の場合は、必ず
{{ }}
を二重引用符で囲みます。
ブールまたは数値である値の場合は、{{ }}
を二重引用符で囲まないでください。
オブジェクトまたは配列である値の場合は、JSON.stringify
の内部で値を囲みます。
正しく書式設定する方法は、少し混乱する可能性があるため、別の簡単な方法として、次のように、オブジェクト全体を動的に作成します。
![Screen Shot 2018-05-09 at 1.11.55 PM.png 1444](https://files.readme.io/c493eb2-Screen_Shot_2018-05-09_at_1.11.55_PM.png)
SOAP API
SOAP APIは、同様に実行することができます。SOAP API( English )を参照してください。
ファイルのアップロード
Retoolでは、現在、ファイルをアップロードする方法が2つ用意されています。
- メタデータを含まないバイナリ・ファイルをアップロードする
- FormDataを使用してファイルをアップロードする
以下に、簡単な例を示します。
![Screen Shot 2018-09-25 at 12.33.03 PM.png 1398](https://files.readme.io/56e6ffc-Screen_Shot_2018-09-25_at_12.33.03_PM.png)
filepickerコンポーネント
ボタンを使用すると、ユーザーはアップロードするファイルを選択できるようになります。上記のスクリーンショットで、ファイルが選択されると、uploadFile
が実行されます。
バイナリを使用したアップロード
![Screen Shot 2018-09-25 at 12.37.46 PM.png 2700](https://files.readme.io/e820ecb-Screen_Shot_2018-09-25_at_12.37.46_PM.png)
FormDataを使用したアップロード
![Screen Shot 2018-09-25 at 12.37.05 PM.png 2702](https://files.readme.io/9980d5c-Screen_Shot_2018-09-25_at_12.37.05_PM.png)
その他の機能
ユーザーの電子メールまたはGoogle IDなどのユーザーの特定の情報を自動的に追加するにはどうすればよいですか
Retoolのオンプレミス・ユーザーのみ利用可能
Retoolで実行するAPIリクエストに、リクエストを実行したユーザーに関する情報を含める必要がある場合、APIリソース設定画面で2つのマジック定数を使用できます。
%USER_PRIMARY_EMAIL%
%USER_GOOGLE_ID%
例えば、すべてのAPIリクエストに、X-User-Email
およびX-User-Google-Id
という追加のヘッダーを含める必要がある場合、次のスクリーンショットのように、2つの新規リソース・ヘッダーを追加することができます。
![Screen Shot 2019-12-19 at 12.20.23 PM.png 2598](https://files.readme.io/4be6671-Screen_Shot_2019-12-19_at_12.20.23_PM.png)
Updated almost 3 years ago