Node.js からMonday.com のデータをクエリ

加藤龍彦
デジタルマーケティング

API Server は、データを外部に公開します。CData API Server のOData エンドポイントを使って、Node.js からMonday.com へのCRUD クエリを実行します。

CData API Server とADO.NET Provider for Monday(もしくは250+ の他のADO.NET Providers)を使って、Monday.com をOData エンドポイントして公開し、Node.js からシンプルなHTTP リクエストでクエリを実現します。本記事ではAPI Server を使ってJSON でフォーマットされたMonday.com のデータをNode.js でリクエストする方法を説明します。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなMonday.com OData サービスを作成していきましょう。

Monday.com への接続

NodeJS からMonday.com のデータを操作するには、まずMonday.com への接続を作成・設定します。

API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Monday.com」を選択します。
事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
CData コネクタの追加方法はこちら >>
それでは、Monday.com への接続設定を行っていきましょう！
Monday 接続プロパティの取得・設定方法

Monday AuditLog API

Monday AuditLog API は、API トークンによる認証のみをサポートしています。
監査ログAPI トークンを生成するには：
1. monday.com アカウントにログインします。
2. 画面右上のアバター（画像アイコン）をクリックします。
3. 表示されたメニューからAdministration を選択します。
4. 左側のナビゲーションでSecurity をクリックします。
5. Audit タブをクリックします。
6. Monitor by API -> Copy をクリックして、AuditLog API トークンをコピーします。
API トークンを取得した後、以下の接続プロパティを設定します。
- Schema："AuditLog" に設定。
- AuthScheme：Token
- APIToken：取得した監査ログAPI トークン
- URL：Monday アカウントURL。ログイン後、自身のMonday ホームページのURL をコピーできます。例：https://your-account-name.monday.com/。
Monday GraphQL API

Monday GraphQL API は、API トークンまたはOAuth 標準による認証をサポートしています。
API トークン
API トークンで接続するには、AuthScheme をToken に設定し、次の手順でAPIToken を取得します。
1. monday.com アカウントにログインします。
2. 画面右上のアバター（画像アイコン）をクリックします。
3. 表示されたメニューからAdministration を選択します（管理者権限が必要です）。
4. 左側のナビゲーションでConnections をクリックし、表示されたページでAPI タブをクリックします。
5. Personal API Token で、Create token をクリックしてパーソナルAPI トークンを作成します。APIToken 接続プロパティをこの値に設定します。
  - すでにトークンを作成している場合は、Personal API Token でCopy ボタンをクリックしてAPI トークンをコピーします。APIToken 接続プロパティをこの値に設定します。
OAuth で認証する場合は、ヘルプドキュメントの「OAuth 認証の使用」セクションを参照してください。
接続情報の入力が完了したら、「保存およびテスト」をクリックします。

Monday 接続プロパティの取得・設定方法

Monday AuditLog API

Monday AuditLog API は、API トークンによる認証のみをサポートしています。

監査ログAPI トークンを生成するには：

monday.com アカウントにログインします。
画面右上のアバター（画像アイコン）をクリックします。
表示されたメニューからAdministration を選択します。
左側のナビゲーションでSecurity をクリックします。
Audit タブをクリックします。
Monitor by API -> Copy をクリックして、AuditLog API トークンをコピーします。

API トークンを取得した後、以下の接続プロパティを設定します。

Schema："AuditLog" に設定。
AuthScheme：Token
APIToken：取得した監査ログAPI トークン
URL：Monday アカウントURL。ログイン後、自身のMonday ホームページのURL をコピーできます。例：https://your-account-name.monday.com/。

Monday GraphQL API

Monday GraphQL API は、API トークンまたはOAuth 標準による認証をサポートしています。

API トークン

API トークンで接続するには、AuthScheme をToken に設定し、次の手順でAPIToken を取得します。

monday.com アカウントにログインします。
画面右上のアバター（画像アイコン）をクリックします。
表示されたメニューからAdministration を選択します（管理者権限が必要です）。
左側のナビゲーションでConnections をクリックし、表示されたページでAPI タブをクリックします。
Personal API Token で、Create token をクリックしてパーソナルAPI トークンを作成します。APIToken 接続プロパティをこの値に設定します。
- すでにトークンを作成している場合は、Personal API Token でCopy ボタンをクリックしてAPI トークンをコピーします。APIToken 接続プロパティをこの値に設定します。

OAuth で認証する場合は、ヘルプドキュメントの「OAuth 認証の使用」セクションを参照してください。

API Server のユーザー設定

次に、API Server 経由でMonday.com にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

Monday.com 用のAPI エンドポイントの作成

ユーザーを作成したら、Monday.com のデータ用のAPI エンドポイントを作成していきます。

まず、「API」ページに移動し、「テーブルを追加」をクリックします。
アクセスしたい接続を選択し、次へをクリックします。
接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でMonday.com への接続を設定してユーザーを作成し、API Server でMonday.com データのAPI を追加しました。これで、OData 形式のMonday.com データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

Node.js からMonday.com OData フィードを利用

OData フィードはNode.js で簡単に使用できます。Node.js のHTTP クライアントを使用して、API Server のOData エンドポイントからJSON 形式のデータをリクエストしていきましょう。リクエストを行った後、レスポンスの本文を作成し、JSON.parse() 関数を呼び出してレコードに解析できます。

以下のコードはInvoices データに対して認証されたリクエストを行います。以下のURL の例では、Status カラムの値がSENT のレコードを検索する単純なフィルターを適用しています。

var http = require('http');
http.get({
  protocol: "http:",
  hostname:"MyServer.com",
  port:MyPort,
  path: "/api.rsc/Invoices?$filter=" + encodeURIComponent("Status eq 'SENT'"),
  auth:'MyUser:MyAuthtoken'
},
function(res) {
  var body = '';
  res.on('data', function(chunk) {
    body += chunk;
  });
  res.on('end', function() {
    console.log(body);
    var jsonData = JSON.parse(body);
  });
}).on('error', function(e) {
  console.log("Error: ", e);
});

はじめる準備はできましたか？

詳細はこちら、または無料トライアルにお申し込みください：

CData API Server お問い合わせ

Node.js からMonday.com のデータをクエリ

API Server の設定