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 つのレコードのステータスを更新する。
  • レコードコメントの投稿

準備

Restlet Client

こちらのツールは、REST API を実行するためのクライアントです。
本格的な開発者は cURL(カール)を使うことが多いですが、Restlet Client は Chrome ブラウザーの拡張機能のため、手軽に使えてとても便利です。

Restlet Client の追加

Restlet Client のページ (External link) にアクセスして「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 の画面を介さずに他サービスから連携可能となりました。

information

この Tips は、2017 年 5 月版 kintone で動作を確認しています。