【外部連携】 APIから計測データを取得しCSVへ保存する（実装事例・Powershell） – LiLz株式会社

LiLz GaugeのAPIでは計測した値を取得し、自社システムへ取り込む形で加工をすることができます。
この記事では実装例として、Powershell スクリプト（.ps1）を利用した連携例を紹介します。

実行内容

以下を実行するサンプルコードを本記事では公開しています。

現在時間（now）から24時間以内の測定データを取得
csvファイルへ変換
変換したcsvファイルを特定のでディレクトリへ移動

実行環境

WIN10以上
Powershellがインストールされている端末

サンプルコード

#PowerShell

# 現在の時間を取得
$now = Get-Date

# 時刻をJSTに設定
$jst = [System.TimeZoneInfo]::FindSystemTimeZoneById("Tokyo Standard Time")

# 時刻をJSTに変換
$nowJST = [System.TimeZoneInfo]::ConvertTime($now, $jst)

# 日付のFormatを定義
$dateFormat = 'yyyy-MM-ddTHH:mm:sszzz'
$nowJSTFormatted = $nowJST.ToString($dateFormat)

# 開始時間を設定
$fromDate = $nowJST.Date.AddDays(0)
$fromDatetime = [System.TimeZoneInfo]::ConvertTimeToUtc($fromDate, $jst).ToString("yyyy-MM-ddTHH:mm:ss+00:00")

# 終了時間を設定
$untilDate = $nowJST.Date.AddDays(1)
$untilDatetime = [System.TimeZoneInfo]::ConvertTimeToUtc($untilDate, $jst).ToString("yyyy-MM-ddTHH:mm:ss+00:00")

# 利用するAPIのエンドポイントを指定
$apiEndpoint = "https://lilz.io/lilzgauge/api/measurements/v3"
# APIアクセストークンを指定
## アクセストークンの取得方法：https://support.lilz.jp/hc/ja/articles/4409852935449
$authToken = "XXXXXX"

# パラメーターを指定
## APIの引数に必要なidの取得方法：https://support.lilz.jp/hc/ja/articles/8190547977241
$direction = "ascending"
$managementUnitId = "XXXXXXX"
$pageSize = 100

# API Requestを実行
$headers = @{
"accept" = "application/json"
"Authentication-Token" = $authToken
}
$queryParams = @{
direction = $direction
from_datetime = $fromDatetime
management_unit_id = $managementUnitId
page_size = $pageSize
until_datetime = $untilDatetime
}
$response = Invoke-RestMethod -Uri $apiEndpoint -Headers $headers -Body $queryParams -Method Get

# CSVへ日付（datetime）, 計器名（gauge.name）, 測定値（value）, 単位（unit）を格納
$csvData = $response.records | 
Select-Object datetime, @{Name='name'; Expression={$_.gauge.name}}, value, unit | 
ConvertTo-Csv -NoTypeInformation

# CSVファイルを移動するフォルダパスを指定
$outputDir = "C:\Users\XXXX\XXXX"
# ファイル名"LiLz Gauge output yyyyMMdd-HHmmss"と指定
$outputFilename = "LiLz Gauge output $(Get-Date -Format 'yyyyMMdd-HHmmss').csv"
# ファイルを移動
$outputPath = Join-Path -Path $outputDir -ChildPath $outputFilename
$csvData | Out-File -Encoding utf8 $outputPath