まずはじめに
HTTP リクエストの発行
自動化によって、Trello から外部システムに GET、POST、PUT の HTTP リクエストを発行できます。
自動化ルール、カード ボタン、および期限の自動化では、[コンテンツ] タブで get、post to、および put to アクションを利用できます。
ボード ボタンおよびカレンダーの自動化では、これらのアクションは [その他] タブで利用できます。
POST と PUT の各リクエスト
POST と PUT の各リクエストによって、リクエストと併せて送信するカスタム ヘッダーを指定できます。
ヘッダーは JSON オブジェクトとして指定されます。次に例を示します。
1
{"Content-Type": "text/plain", "X-My-Custom-Header": "My header value"}
POST と PUT の各リクエストに対するペイロードのコンテンツタイプは既定で application/json ですが、カスタム ヘッダーを指定することで上書きできます。
URL で使用される変数は有効な URL を作成するために URL に自動でエンコードされて、ペイロードで使用される変数は有効な JSON 文字列の一部になるように自動でエスケープされます。
レスポンス
自動化によって HTTP リクエストを発行した後、結果は {httpresponse} 変数に格納されて、自動化にある以降のアクションの一部として使用できます。
応答が JSON オブジェクトの際は、この変数はオブジェクト内のプロパティを取得するためのアクセス表記を提供します (例: {httpresponse.myproperty})。
例:
次のカード ボタンの自動化は、GET リクエストで取得された JSON ファイルから抽出されたデータを含むコメントを投稿します。
1
2
get url "https://example.com/movie-search?q={cardname}",
and post comment "Result count: {httpresponse.relatedMovies.length} \n\n First result: {httpresponse.relatedMovies[0].title}"
{httpresponse} 変数には次の内容が含まれます。
1
2
3
4
5
6
{
relatedMovies:[
{title: 'Movie 1'},
{title: 'Movie 2'},
],
};
自動化が実行されると、次のコメントがカードに追加されます。
この内容はお役に立ちましたか?