kintone Webhook(REST API)& Microsoft Power Automate を使って Slack に投稿する
はじめに
「
kintone Webhook & Microsoft Power Automate を使って Slack に投稿する」で、kintone の画面上から操作して、他サービスに連携する Tips を紹介しました。
今回は 2017 年 6 月に新しく搭載される予定の、REST API による操作でも Webhook が動作するしくみを紹介します。
2017 年 6 月(予定)時点の対応 API
- レコードの登録(1 件)
- レコードの更新(1 件)
- 1 つのレコードのステータスを更新する。
- レコードコメントの投稿
準備
- Chrome ブラウザー
- REST API を実行できるツールを用意する。
ここでは、Chrome の拡張機能「Restlet Client」で説明します。 - 「
kintone Webhook & Microsoft Power Automate を使って Slack に投稿する」をまず試してみる。
kintone 画面上からの Webhook 連携が前提となります。
Restlet Client
こちらのツールは、REST API を実行するためのクライアントです。
本格的な開発者は cURL(カール)を使うことが多いですが、Restlet Client は Chrome ブラウザーの拡張機能のため、手軽に使えてとても便利です。
Restlet Client の追加
Restlet Client のページ にアクセスして「Chrome に追加」をクリックし、拡張機能を追加すると Chrome の右上に Restlet Client のアイコンが追加されているのでクリックします。
Restlet Client で POST
URL、ヘッダー認証はご利用中の kintone 環境をお使いください。
-
URL : https://{subdomain}.cybozu.com/k/v1/record.json
-
METHOD : POST
-
HEADERS
- Content-Type : application/json
- X-Cybozu-API-Token : アプリごとに発行できる API トークン
X-Cybozu-Authorization :「ログイン名:パスワード」を Base64 でエンコードしたものでも可能
-
BODY
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
{ "app": 1, "record": { "受付番号": { "value": "AA101" }, "Title": { "value": "緊急 工具手配" }, "内容": { "value": "機器の設置で工具が\\n必要になりました。" }, "作業期限": { "value": "2017-05-31" } } }
record
配下はフィールドコードを利用しています。
リクエストボディの記述方法は、 1 件のレコードを登録する を確認してください。
kintone の画面
REST API によるレコード登録後の画面です。
Slack への通知
「 kintone Webhook & Microsoft Power Automate を使って Slack に投稿する」で紹介した Slack への通知画面です。
REST API を使ってデータを登録することで、kintone の画面を介さずに他サービスから連携可能となりました。
この Tips は、2017 年 5 月版 kintone で動作を確認しています。