TECH BLOG

MENU

MotionBoard

MotionBoard

MotionBoardにはいくつかWeb APIが用意されています。Web APIを使うことで大量のユーザーを一括で登録したり、都度手動で挙げているExcelやCSVを自動でアップロードできます。Web APIってなに!?となった方、安心してください。今回は簡単な方法でWeb APIを試す方法を紹介します!

 

Web APIって?

APIとはApplication Programming Interfaceの略で、各企業が持っている基幹システムやその他様々なサービスとデータをやり取りする仕組みです。API自体はJavaやPythonなどのプログラム上で利用できる形式で提供されることが多く、自由度が高くサービスの開発効率を大幅に増加させますが知識がないと扱いづらいです。

その中でもWeb APIは、HTTPおよびHTTPSというルールでやり取りできる仕組みです。ブラウザでURLを打つような感覚で利用でき、より多くのユーザーが扱えるようになっています。また、MotionBoardでは様々なWeb APIが提供されています。

Web APIの利用にあたって、大まかに分けて必要な情報が4つあります。

MotionBoardのWeb APIを例に、一つずつ紹介していきます。

 

サーバーURL

サーバーURLは「どのMotionBoardへアクセスするか?」を決める情報になります。そのため、サーバーURLはMotionBoardの環境(オンプレ・クラウド)に合わせて指定しましょう。MotionBoard CloudはいつもログインするURL(https://cloud.motionboard.jp/)とは別なので注意しましょう。

・オンプレ

http://[IP or ホスト名]:[ポート番号]/motionboard/

・MotionBoard Cloud

https://cloud-up.motionboard.jp/motionboard/

・MotionBoard Cloud for Salesforce

https://sfdc-up.variocloud.jp/motionboard/

リアルタイム連携する場合はまた別のサーバーURLになりますので下記のマニュアルをご覧ください。

Web APIの利用方法(リクエストURL)

 

リソースURI

リソースURIは利用するWeb APIによって異なりますので、利用する際はそれぞれのマニュアルページをご覧くださいね。例えば「ユーザーを登録する」場合は下記がリソースURIになります。

rest/directory/import/local/user
ユーザーの登録、更新、削除

 

CSVをMotionBoardの共有フォルダにアップロードする際は、このようなリソースURIになります。

rest/csv/put/shared/<フォルダーパス>/<CSVファイル名>
共有CSVファイルのアップロード

 

パラメータ

パラメータにはすべてのWeb APIで共通のものと、各Web APIごとに用意されたものの2種類があります。まずはすべてのWeb APIで共通のパラメータについて紹介します。共通のパラメータは「どの」環境に対して「誰が」Web APIを叩くのかといった最低限必要な情報に該当します。

 

続いて各Web API個別のパラメータです。例えば、「ユーザーを登録する」場合に必要なパラメータは下記になります。(※ 必須のもののみ抜粋)

 

cURLを使って実際にWeb APIを使ってみる!

cURLの起動と使い方

Web APIを使う上で必要な情報がそろったところで、早速Web APIを使ってみましょう。Web APIを使う(俗に「Web APIを叩く・キックする」と表現することもあります)方法はたくさんあります。その中でもcURL(「カール」と読みます)というコマンドを使った方法は、Windows・Linux ともに標準で使え、かつ簡単に試すことができます。

では早速使ってみましょう。Windowsの場合はコマンドプロンプトを開きます。スタートメニューから「cmd」と検索するとヒットするかと思います。

コマンドプロンプトに、下記のようなフォーマットでWeb APIに必要な情報を指定し、Enterを押すだけでMotionBoardのWeb APIを使うことができます!

curl -X POST -F "[パラメータ1]" -F "[パラメータ2]" -F "[パラメータ3]" [サーバーURL]/[リソースURI]

パラメータは一つではないので、必要な数だけ「-F」をつけて追加します。

コマンドの完成形

最後に、ユーザーを登録するWeb APIを例に最終的なコマンドの書式を紹介します。

curl -i -X POST -F "tenant=abcd1234" -F "id=user" -F "pw=password" -F "uploadFile=@C:/Users/add_user_list.csv" -F "command=add" https://cloud-up.motionboard.jp/motionboard/rest/directory/import/local/user

まずは、すべてのWeb APIに共通のパラメータを指定します。

 

続いて、Web API個別のパラメータを指定します。今回はユーザー登録のWeb APIのため、ユーザーのリストファイルの場所(uploadFile)と、追加か削除かといった情報(command)を指定します。

 

最後に、サーバーURLとリソースURIをつなげてアクセスするURLを完成させます。このURLは「エンドポイント」と呼ばれます。

https://cloud-up.motionboard.jp/motionboard/rest/directory/import/local/user

ではコマンドを入力してEnterを押して実行してみましょう。cURLでは「-i」を指定することで、コマンドが成功したかといった結果(レスポンスと呼びます)を確認することができます。成功するとこのようなテキストが出力されます。

HTTP/1.1 200
Transfer-Encoding: chunked
Date: Thu, 18 May 2023 05:26:59 GMT
Server: MotionBoard 6.4

一行目の「200」という番号はステータスコードと呼ばれ、200だと成功、404だとURLが間違っている可能性が高いです。エラーが出た場合はステータスコードやエラーメッセージを見て、今一度URLやパラメータが間違っていないか確認してみましょう。以上がMotionBoardのWeb APIの簡単な使い方の紹介になります!

まとめ

本記事では、MotionBoardのWeb APIの簡単な使い方を紹介しました。MotionBoardには、今回紹介したユーザー登録やCSVのアップロード以外にもたくさんのWeb APIが用意されています!

Web API一覧

 

本記事で紹介した方法を試していただき、他のWeb APIを使った自動化や工数削減を実現できれば幸いです。本記事を参考に、実際に一括ユーザー登録などを行ってみてください!

この記事にリアクションしてみませんか?

  • 分かりやすい (2)
  • 問題が解決した (0)
評価いただいてありがとうございます!
プロフィールへ

宇根 昌和

新卒でウイングアーク1stへ入社、プリセールス活動を行っています。Pythonをベースに様々なツールからデータをDr.Sumへ集約しMotionBoardで可視化する仕組みを作ったり、Web APIを使ったデータ蓄積ノウハウをテーマにイベント登壇したりしています。Djangoを使ったWebアプリ作成や機械学習も勉強中です!

Related article

Related article関連記事

Pick up

Pick upおすすめ記事

【まとめ】invoiceAgentのWeb APIを使ってみる

  • #API

2023.04.05

invoiceAgent

ユーザーごとに閲覧可能なデータを制御しよう!

  • #集計表
  • #データ加工

2021.02.26

Dr.Sum

まるでWebサイト!? 折りたたみメニューの作り方!

  • #集計表
  • #デザイン
  • #コンテナ
  • #ボタン

2021.01.13

MotionBoard

Ranking

Rankingランキング

1

Excelのデータを加工したい。~変換(横持ち⇔縦持ち)について~

  • #データ取り込み
  • #データ加工

2021.01.19

Dr.Sum

2

棒グラフを大きい順番に並び替えたい!(ソートしたい)

  • #集計表
  • #グラフ
  • #デザイン

2019.06.15

MotionBoard

3

SVFエラー解決までの近道 -帳票が出力されない編

  • #帳票作成・出力

2018.11.06

SVF

Info

Information

ウイングアーク1stからのお知らせ