水道情報活用システム
基本仕様書

別冊

機器ベンダー向け
標準インターフェイス(デバイス)
仕様書
WPSC003 EDITION 1.1

2021 年 2 月

水道情報活用システム標準仕様研究会

WPSC003-Ed.1.1 2021-02

本書は、国立研究開発法人 新エネルギー・産業技術総合開発機構「IoT を活用した新産業モデ
ル創出基盤整備事業」における「水道 IoT の社会実装推進に向けた検討」、及び「高度なデー
タ活用を可能とする社会インフラ運営システムの開発」事業により作成されたものに、経済産業省補助事業（補助事業者：株式会社 JECC）「水道施設情報整備促進事業」により改定され、水道情報活用システム標準仕様研究会により改定されました。
WPSC003-Ed.1.1 2021-02

水道情報活用システム標準仕様研究会及び本ドキュメント(本使用許諾条件に添付されて提供されるドキュメントをいい、以下同じ)の原著作権者である国立研究開発法人新エネルギー・産業
技術総合開発機構、（以下「当研究会等」と総称します）は、以下の条件のもとで本ドキュメン
トを使用、複製および頒布することを無償で許諾します。本ドキュメントを使用、複製または頒布した場合には、以下の条件に同意したものとします。
1. 本ドキュメントの中に含まれる著作権表示および本使用許諾条件を、本ドキュメントの全部または一部を複製したものに表示してください。
2. 本ドキュメントを使用したサービスの提供を含め営利目的に本ドキュメントを使用することができますが、本ドキュメントのみを単独で販売することはできません。
3. 第４項に定める場合を除き、本ドキュメントを使用したサービスの提供に際して、事前の書面による当研究会等の許可なく、それらの宣伝、広告活動に当研究会等の名称を使用することはできません。
4. 本ドキュメントを使用して得られた結果を、形態を問わず、出版、発表において公表する場
合には、本ドキュメントと当研究会等の名称を引用等において明示してください。
5. 本ドキュメントは現状有姿で提供されるものであり、当研究会等は、本ドキュメントに関して、商品性および特定目的への適合性、エラー・バグ等の不具合のないこと、第三者の特許権、実用新案権、意匠権、商標権、著作権その他の知的財産権を侵害するものではないこと
を含め、明示たると黙示たるとを問わず、一切の保証を行わないものとします。また、当研究会等は、本ドキュメントの誤りの修正その他いかなる保守についても義務を負うものではありません。
6. 当研究会等は、本ドキュメントの使用または使用不能、複製、頒布、その他本ドキュメント
または本使用許諾条件の規定に関連して生じたいかなる損害(特別損害、間接損害、逸失利
益を含みますが、これに限りません)または第三者からのいかなる請求についても、法律上の根拠を問わず一切責任を負いません。当研究会等がかかる損害または請求の可能性について知らされていた場合も同様とします。
7. 本ドキュメントは、一般事務用、家庭用、通常の産業用等の一般的用途を想定して作成されているものであり、原子力施設における核反応制御、航空機自動飛行制御、航空交通管制、
大量輸送システムにおける運行制御、生命維持のための医療用機器、兵器システムにおけるミサイル発射制御など、極めて高度な安全性が要求され、仮に当該安全性が確保されない場
合、直接生命・身体に対する重大な危険性を伴う用途(以下「ハイセイフティ用途」という)を想定して作成されたものではなく、当該ハイセイフティ用途に要する安全性を確保する措置を施すことなく、本ドキユメントを使用しないものとします。また、ハイセイフティ用途に本ドキュメントを使用したことにより発生する、いかなる請求または損害賠償に対しても当研究会等は一切の責任を負わないものとします。

WPSC003-Ed.1.1 2021-02

- 目次 –

1. はじめに ........................................................................ 1
1.1 本ドキュメントの目的 ......................................................... 1
1.2 水道情報活用システム標準仕様のドキュメント.................................... 2
ドキュメント体系 .......................................................... 2
対象読者と役割 ............................................................ 3
本書の対象読者 ............................................................ 4
1.3 参考文献 ..................................................................... 5
1.4 用語の説明 ................................................................... 8
1.5 本ドキュメントの記載範囲 .................................................... 10
2. IoT ゲートウェイ利用までに必要な事前準備 ........................................ 11
2.1 ゲートウェイ登録 ............................................................ 12
2.2 計測データモデル登録 ........................................................ 14
2.3 ゲートウェイ接続 ............................................................ 15
2.4 ゲートウェイ切断 ............................................................ 17
3. 機器ベンダー向け標準インターフェイス（デバイス）仕様 ............................ 18
3.1 インターフェイス一覧 ........................................................ 18
3.2 プロトコル .................................................................. 19
3.3 セキュリティ ................................................................ 25
3.4 データの分割送信 ............................................................ 26
3.5 基本的な処理の流れ .......................................................... 28
ゲートウェイ接続 ......................................................... 28
ゲートウェイ切断 ......................................................... 29
データ操作(追加、変更、削除、参照) ....................................... 30
4. インターフェイス仕様 ........................................................... 34
4.1 ゲートウェイ接続インターフェイス ............................................ 35
4.2 ゲートウェイ切断インターフェイス ............................................ 40
4.3 要求データ取得共通インターフェイス .......................................... 44
4.4 即時監視インターフェイス .................................................... 57
WPSC003-Ed.1.1 2021-02

4.5 定周期監視インターフェイス .................................................. 63
4.6 制御値設定インターフェイス .................................................. 79
4.7 公開鍵証明書ファイル取得インターフェイス .................................... 91
4.8 ファイル登録操作インターフェイス ............................................ 96
4.9 ファイル削除操作インターフェイス ............................................ 99
5. データプロパティ仕様 .......................................................... 102
5.1 即時/定周期監視/制御値設定データのプロパティ仕様 ............................ 102
5.2 ゲートウェイ接続情報のプロパティ仕様 ....................................... 103

WPSC003-Ed.1.1 2021-02

1. はじめに1.1 本ドキュメントの目的
本ドキュメントは、社会インフラ水道情報活用システム(以下、水道情報活用システム)標準
仕様における基本仕様書の別冊である。
基本仕様書では、水道情報活用システムを実現する基本仕様として、水道情報活用システムの全体構成と基本的に守るべきルール、標準インターフェイスを規定している。
本ドキュメントは、基本仕様書で規定した標準インターフェイスの一つである機器ベンダー
向け標準インターフェイス(デバイス)仕様を記載したドキュメントである。
本ドキュメントにより、IoT ゲートウェイ・デバイスベンダーが、IoT ゲートウェイを水道標
準プラットフォームへ初期接続する際にどのような仕様で接続し、運用時にどのような仕様でデータの取得や追加などのデータ操作を行えばよいかを理解することを目的とする。

1
WPSC003-Ed.1.1 2021-02

1.2 水道情報活用システム標準仕様のドキュメント
ドキュメント体系
水道情報活用システム標準仕様のドキュメント体系を以下に示す（図 1-1）。

水道情報活用システム
基本仕様書(WPSC001)

アプリベンダー向け
標準インターフェイス
仕様書(WPSC002)
機器ベンダー向け
標準インターフェイス（デバイス）仕様書(WPSC003)
機器ベンダー向け
標準インターフェイス（システム）仕様書(WPSC004)

IoT ゲートウェイ
外部仕様書(WPSC009)

システムゲートウェイ
外部仕様書(WPSC010)

水道標準プラットフォーム
外部仕様書(WPSC005)

水道 CPS データ
プロファイル仕様書(WPSC006)

CPS/IoT セキュリティ
仕様書(WPSC007)ドキュメント名称/略称

初期情報設定シート(WPSC008)(ドキュメント番号)：水道情報活用システム
基本仕様書：水道情報活用システム
基本仕様書 別冊
：本書

マッピングベンダー向け
データ共有仕様書(WPSC011)

標準汎用インターフェイス
仕様書(WPSC012)

図 1-1: ドキュメント体系

2
WPSC003-Ed.1.1 2021-02

対象読者と役割
水道情報活用システム標準仕様の対象読者と役割を以下に示す。
① 事業体：
水道情報活用システム上のアプリケーションを利用して、デバイス・システムのデータを活用したサービスを享受する事業体。
② アプリケーション開発ベンダー：
水道情報活用システム上のアプリケーションを開発し、デバイス・システムのデータを活用したサービスを事業体に提供するベンダー。
③ IoT ゲートウェイ・デバイスベンダー：
水道情報活用システム上の IoT ゲートウェイを開発し、デバイスのデータを水道標準
プラットフォームへ流通するベンダー。
④ システムゲートウェイ・システムベンダー：
水道情報活用システム上のシステムゲートウェイを開発し、各種台帳システムや料金システム等の業務システムのデータを水道標準プラットフォームへ流通するベンダー。
⑤ プラットフォーマー：水道情報活用システム上の水道標準プラットフォームを提供し、デバイス・システムのデータを流通するサービス提供および運営を行う第三者機関。
⑥ システムインテグレーター：
水道情報活用システム全体の設計を行い、アプリケーション開発ベンダーや IoT ゲー
トウェイ・デバイスベンダー、システムゲートウェイ・システムベンダーを統率し、水道情報活用システムを事業体に導入するベンダー。

3
WPSC003-Ed.1.1 2021-02

本書の対象読者
本書の対象読者を以下に示す（表 1-1)。
水道情報活用システム 基本仕様書は、(1)～(6)の対象読者が必ず参照すべきドキュメントである。その別冊の各仕様書は、読者の役割に応じて参照すべきドキュメントである。
表 1-1: 仕様書別対象読者
対象読者
ドキュメン

WPSC001

WPSC002

WPSC003(1)～(6)は 1.2.2 項参照

ドキュメント名称
ト番号

水道情報活用システム

基本仕様書

水道情報活用システム

基本仕様書

別冊

アプリベンダー向け標準インターフェイス仕様書
水道情報活用システム

基本仕様書

別冊

(1)

(2)

(3)

(4)

(5)

(6)

○

○

○

○

○

〇

－

○

－

－

○

〇

－

－

○

－

○

〇

－

－

－

○

○

〇

－

△

△

△

○

△

－

○

○

－

○

〇

－

○

○

○

○

〇

○

△

△

△

○

〇

－

－

○

－

－

〇

－

－

－

○

－

〇

△

○

－

△

－

〇

△

○

〇

－

△

〇

機器ベンダー向け標準インターフェイス(デバイス)仕様書
WPSC004

WPSC005

WPSC006

WPSC007

水道情報活用システム

WPSC009

WPSC010WPSC011

WPSC012

別冊

機器ベンダー向け標準インターフェイス(システム)仕様書
水道情報活用システム

基本仕様書

別冊

水道標準プラットフォーム外部仕様書
水道情報活用システム

基本仕様書

別冊

水道 CPS データプロファイル仕様書
水道情報活用システム

基本仕様書

別冊

CPS/IoT セキュリティ仕様書
水道情報活用システム
WPSC008

基本仕様書

基本仕様書

別冊

初期情報設定シート
水道情報活用システム

基本仕様書

別冊

IoT ゲートウェイ外部仕様書
水道情報活用システム

基本仕様書

別冊

システムゲートウェイ外部仕様書
水道情報活用システム

基本仕様書

別冊

マッピングベンダー向けデータ共有仕様書
水道情報活用システム

基本仕様書

別冊

標準汎用インターフェイス仕様書〇：必読、 △：必要に応じて読む、－：読まなくてもよい：本書

4
WPSC003-Ed.1.1 2021-02

1.3 参考文献
水道情報活用システム標準仕様を参照する際の参考文献を以下に示す(表 1-2)。
表 1-2: 参考文献
No.

1

参考文献

ISO 8601

説明

日付と時刻の表記について規定する ISO による国際規格。
URL※：https://www.iso.org/iso-8601-date-and-time-format.html

水道標準プラットフォームで利用するメッセージングプロトコルで

2

MQTT Protocol
Specification

ある MQTT について、OASIS により規定されたプロトコル仕様。

URL※：
http://public.dhe.ibm.com/software/dw/webservices/wsmqtt/mqtt-v3r1.html

認証プロトコルについて規定する、OpenID ファウンデーションによ3

OpenID Connect

るプロトコル仕様。
URL※：http://www.openid.or.jp/document/

4

OpenID Connect
Core 1.0

水道標準プラットフォームで利用するアイデンティティ連携プロト
コル仕様。
URL※：http://openid.net/specs/openid-connect-core-1_0.html

Hypertext Transfer Protocol(HTTP/1.1)について規定する IETF に5

RFC 2616

よる技術仕様。
URL※：https://tools.ietf.org/html/rfc2616

暗号化通信プロトコルである HTTP over TLS(本ドキュメントでは
6

RFC 2818「HTTP(S)」と表記)について規定する、IETF によるプロトコル仕様。
URL※：https://tools.ietf.org/html/rfc2818

5
WPSC003-Ed.1.1 2021-02

No.

参考文献

説明

セキュアな通信を行うためのプロトコルである Transport Layer
7

RFC 5246

Security(TLS)について規定する、IETF によるプロトコル仕様。
URL※：https://tools.ietf.org/html/rfc5246

水道標準プラットフォームで利用する通信プロトコルである
8

RFC 6455

WebSocket について、IETF により公開されたプロトコル仕様。
URL※：https://tools.ietf.org/html/rfc6455

OpenID Connect のベースである OAuth 2.0 のトークン仕様について
9

RFC 6750

規定する、IETF による技術仕様。
URL※：https://tools.ietf.org/html/rfc6750

HTTP/1.1 におけるセマンティクスとコンテンツについて規定する
10

RFC 7231

IETF による技術仕様。
URL※：https://tools.ietf.org/html/rfc7231

XML Encryption
11

Syntax andProcessing

XML Signature
12

Syntax andProcessing

XML 暗号について規定する W3C 勧告。
URL※：http://www.w3.org/TR/xmlenc-core1/

XML 署名について規定する W3C 勧告。
URL※：http://www.w3.org/TR/xmldsig-core2/※: 2017 年 7 月時点の URL を参考に記載

6
WPSC003-Ed.1.1 2021-02

その他、参考にする報告書を以下に示す。
経済産業省「平成２８年度ＩｏＴ推進のための社会システム推進事業（スマート工場実証事
業）報告書」
http://www.meti.go.jp/policy/mono_info_service/mono/smart_mono/H28SmartFactory_Dat
aProfile_Security_Report.pdf
http://www.meti.go.jp/policy/mono_info_service/mono/smart_mono/H28SmartFactory_Dat
aProfile_Security_Report_Attachment1.pdf
http://www.meti.go.jp/policy/mono_info_service/mono/smart_mono/H28SmartFactory_Dat
aProfile_Security_Report_Attachment2.pd
経済産業省「平成２８年度ＩｏＴ推進のための社会システム推進事業（社会インフラ分野でのＩｏＴ活用のための基盤整備実証プロジェクト）」
http://www.meti.go.jp/meti_lib/report/H28FY/000060.pdf
http://www.meti.go.jp/meti_lib/report/H28FY/000061.pdf
http://www.meti.go.jp/meti_lib/report/H28FY/000062.pdf

7
WPSC003-Ed.1.1 2021-02

1.4 用語の説明
水道情報活用システム標準仕様で使用する用語の説明を以下に示す(表 1-3)。
表 1-3: 用語の説明
No.

1

用語

AI

コンピュータを使って学習・推論・判断等、人間の知能(Artificial Intelligence)の働きを人工的に実現するもの。

API
2

説明

(Application Programming
Interface)

ソフトウェアコンポーネントが互いにやり取りするのに使用するインターフェイスの仕様。

CPS/IoT を活用して、デバイス・システムのデータを流通
3

CPS/IoT システム

させ、データを活用した付加価値の高いサービスを提供するシステム。

4

DUNS Number

ダンアンドブラッドストリート（D&B）社が開発した 9 桁(Data Universal Numberingの企業識別コードのことで、世界の企業を一意に識別でSystem Number)

きる企業コード。

FQDN
5(Fully Qualified Domain
Name)

IANA
6

(Internet Assigned Numbers
Authority)

完全修飾ドメイン名。ホスト名とドメイン名などすべてを省略せずに指定した文字列。

IP アドレス・ドメイン名・ポート番号等の標準化・割り当て等インターネットに関連する番号を管理する組織。

国際的な流通標準化機関である GS1 が定める国際標準の
7

JAN コード

識別コードを設定するために必要となるコード。国際的(Japanese Article Number)には GS1 Company Prefix と呼ばれ、日本では最初の 2 桁が「45」又は「49」で始まる 9 桁又は 7 桁の番号。

MIME タイプ
8(Multipurpose Internet Mail
Extension)

IANA に登録されている、転送するデータの種類や形式を判別する為の識別子。

8
WPSC003-Ed.1.1 2021-02

No.

9

10

用語

TDB 企業コード(Teikoku Data Bank)

耐タンパー性説明
帝国データバンクが独自に取材・収集した企業情報に加え、各種公的情報を基に、1 社＝1 コードとして厳格に設定した数字 9 桁の企業識別コード。

非正規な手段による外部からの解析が容易に出来ないよ
う、データの読み取りや改ざんを防ぐ能力。

「平成 28 年度 IoT 推進のための社会システム推進事業
11

データプロファイル（スマート工場実証事業）」の成果物であり、水道情報
活用システム上でデータをやり取りする際のデータ流通
のルール。

12

パディング

決められたデータの長さに対してデータが短い場合に、データを追加してデータの長さを合わせる処理。

一般財団法人日本情報経済社会推進協会(JIPDEC)が一元的に管理する、企業を識別する業界横断的な企業コー
13

標準企業コード

ド。
企業を一意に識別できる 6 桁の企業識別コードと、各企業が採番、管理を行う 6 桁の枝番で構成される。
パケット通信において、データの転送先や転送経路など

14

ペイロードデータを制御するための情報を含むヘッダや、データの破損などを検査するトレーラなどの付加的情報を除いた、ユーザーが送信したいデータ本体。

15

メッセージダイジェスト

16

リダイレクト17

レルム名

任意の長さの文字列を固定長のビット列に変換するアルゴリズム。

ウェブサイトを訪れたユーザーを、自動的に他のウェブページに転送する処理。

それぞれのレルム(同一の認証ポリシーを適用する範囲)を識別する名称。

9
WPSC003-Ed.1.1 2021-02

1.5 本ドキュメントの記載範囲
本ドキュメントは、水道情報活用システムにおける標準インターフェイスの内、機器ベンダ
ー向け標準インターフェイス(デバイス)仕様を示す。
本ドキュメントの記載範囲を以下に示す(図 1-2)。

図 1-2: 本ドキュメントの記載範囲

社会インフラ水道情報活用システム標準仕様では、
IoT ゲートウェイからデバイスに対して、制御信号などのデバイスの動作に係わる指示を送ることは想定していない。

10
WPSC003-Ed.1.1 2021-02

2. IoT ゲートウェイ利用までに必要な事前準備
IoT ゲートウェイが利用可能になるまでに、事前に準備する初期情報設定の項目を以下に示す。初期情報設定の全体の流れは、初期情報設定シートの水道情報活用システムの利用開始までの全体の流れを参照。
なお証明書は、定期的に水道標準プラットフォームにて最新バージョンを更新するが、古いバージョンも一定期間保持する仕様となっている。アプリケーションやゲートウェイが初期
取得時のバージョンのまま運用するか、定期的に最新バージョンに更新するかは、水道標準
プラットフォームの導入時に選択できる。
表 2-1:IoT ゲートウェイ利用までに必要な事前準備項目
No

項目

内容
事業体がプラットフォーマーに対し、IoT ゲートウェイの IoT ゲ

1

ゲートウェイ登録

ートウェイ設定情報を水道標準プラットフォームに登録する。
詳細は、2.1 節を参照。

プラットフォーマーが、設置した機器などの情報を、計測デー
2

計測データモデル登録

タモデルとして水道標準プラットフォームに登録する。
詳細は、2.2 節を参照。

事業体が、IoT ゲートウェイを水道標準プラットフォームに接続
3ゲートウェイ接続する。
詳細は、2.3 節、3.5.1 項、4.1 節を参照。

既に水道標準プラットフォームへ接続している IoT ゲートウェイ
4

ゲートウェイ切断

を水道標準プラットフォームから切断する。
詳細は、2.4 節、3.5.2 項、4.2 節を参照。

11
WPSC003-Ed.1.1 2021-02

2.1 ゲートウェイ登録
IoT ゲートウェイを水道標準プラットフォームに接続するため、IoT ゲートウェイの情報を水
道標準プラットフォームに登録する。情報が登録されていない場合、その IoT ゲートウェイを利用出来ない。
事業体は、ゲートウェイ登録申請を実施する。プラットフォーマーはゲートウェイ登録申請の内容に基づき必要な割り当てを行い、割り当てた情報を事業体へ返送する。事業体は、割り当て情報に基づき水道情報活用システムが利用できるようになる。
発行される設定情報を以下に示す(表 2-2)。ゲートウェイ登録申請については、初期情報設
定シートを参照。

表 2-2: ゲートウェイ登録情報
No.

項目

説明
水道標準プラットフォームが IoT ゲートウェイを一

1

ゲートウェイ ID

意に識別するための識別子。詳細は、基本仕様書の3.1.2 項を参照。

2

ゲートウェイ秘密鍵(TLS 用)相互認証や通信暗号に使用する秘密鍵

3

ゲートウェイ秘密鍵(データ保護用)

データ暗号に使用する秘密鍵

4

ゲートウェイ証明書(TLS 用)

通信暗号に使用する証明書

5

ゲートウェイ証明書(データ保護用)

データ暗号に使用する証明書

水道標準プラットフォームルート証

水道標準プラットフォーム証明書の検証に使用す

明書

る証明書

アプリケーションルート証明書

アプリケーション証明書の検証に使用する証明書

6

7

8

水道標準プラットフォームのホスト
名

水道標準プラットフォームの FQDN 名。アプリケー
ションがアプリベンダー向け標準インターフェイスを使用するために必要。

12
WPSC003-Ed.1.1 2021-02

なお、鍵情報と電子証明書は、定期的に水道標準プラットフォームにて最新バージョンを更新するが、古いバージョンも一定期間保持する仕様となっている。アプリケーションが初期取得時のバージョンのまま運用するか、定期的に最新バージョンに更新するかは、水道標準プラ
ットフォームの導入時に選択できる。

13
WPSC003-Ed.1.1 2021-02

2.2 計測データモデル登録
事業体が計測データモデル登録申請をプラットフォーマーに行い、プラットフォーマーは申請書に記載された内容を水道標準プラットフォームに登録する。
計測データモデル登録情報を以下に示す(表 2-3)。計測データモデルの登録申請については、
初期情報設定シートを参照。
表 2-3: 計測データモデル登録情報
No.

項目

説明

1

施設 ID

2

設備 ID

計測データモデルの詳細は、基本仕様書の 5 章を

3

機器 ID

参照。

4

計測項目番号

14
WPSC003-Ed.1.1 2021-02

2.3 ゲートウェイ接続
IoT ゲートウェイと水道標準プラットフォームを接続するため、IoT ゲートウェイ起動時にIoT ゲートウェイ接続インターフェイスを呼び出す。
ゲートウェイ接続では、IoT ゲートウェイから水道標準プラットフォームへ接続情報を登録する。登録する接続情報を以下に示す(表 2-4)。
表 2-4: ゲートウェイ接続情報
No.

名称

説明
水道標準プラットフォームが IoT ゲートウェイを一意に識別す1

ゲートウェイ ID

2

ゲートウェイ名IoT ゲートウェイの名称

3

ゲートウェイ種別

IoT ゲートウェイの種別を表す文字列

4

事業体 IDIoT ゲートウェイの所有者である事業体の ID

インターフェイスバー

サポートしている機器ベンダー向け標準インターフェイスのバ

ジョン

ージョン

5

6

対応データ種別 IDるための識別子。詳細は、基本仕様書の 3.1.2 項を参照。

サポートするデータ種別 ID。
詳細は、基本仕様書の 4.4.1 項を参照。
サポートするデータ種別のデータを一意に特定するプロパティ

7

対応データ種別プライ

名マリーキープロパティ

例：

名・データ種別が機器情報の場合は機器 ID
・データ種別が設備情報の場合は設備 ID
IoT ゲートウェイが水道標準プラットフォームに対して、送信時

8プロトコル種別に使用する通信プロトコル
・MQTT："MQTT"・HTTP(S)："HTTP"

9

10

11

12

アクセス先ホスト名[定周期監視]
アクセス先ホスト名[即時取得]
アクセス先ホスト名[制御値設定]
対応コンテンツタイプ

定周期監視のアクセス先のホスト名

即時取得のアクセス先のホスト名

制御値設定のアクセス先のホスト名
IoT ゲートウェイがサポートする MIME タイプを指定する。
詳細は、基本仕様書の 4.4.5 項を参照。

15
WPSC003-Ed.1.1 2021-02

水道標準プラットフォームでは、ゲートウェイ接続で登録された情報から IoT ゲートウェイ
を識別する。これにより水道標準プラットフォームは、当該 IoT ゲートウェイが接続しても良い IoT ゲートウェイかどうかを判定する。水道標準プラットフォームに接続しても良いと判断された場合、ゲートウェイ接続情報が水道標準プラットフォームに登録される。これにより、
その IoT ゲートウェイは水道標準プラットフォームと通信できる。水道標準プラットフォームに接続しても良いと判断されなかった場合、水道標準プラットフォームはその IoT ゲートウェ
イの接続を受けつけない。
ゲートウェイ接続の詳細は、3.5.1 項及び 4.1 節を参照。

16
WPSC003-Ed.1.1 2021-02

2.4 ゲートウェイ切断
既に接続している IoT ゲートウェイを水道標準プラットフォームから切断するためには、ゲートウェイ切断インターフェイスを呼び出す。ゲートウェイ切断では、前述(表 2-4)の情報を指定して既に登録された情報を無効にする。その際、水道標準プラットフォームは、当該 IoT ゲ
ートウェイのためのすべての処理を停止する。
水道標準プラットフォームでは、ゲートウェイ切断で指定された IoT ゲートウェイが接続済
みかどうかを判定する。接続済みだった場合、その IoT ゲートウェイの接続を無効にする。接続済みではなかった場合、エラーを返す。
ゲートウェイ切断の詳細は、3.5.2 項及び 4.2 節を参照。

17
WPSC003-Ed.1.1 2021-02

3. 機器ベンダー向け標準インターフェイス（デバイス）仕様
本章では、機器ベンダー向け標準インターフェイス（デバイス）に必要な以下の 5 つを示す。
・インターフェイス一覧
・プロトコル・セキュリティ・データの分割送信
・基本的な処理の流れ

3.1 インターフェイス一覧
水道情報活用システムがサポートする機器ベンダー向け標準インターフェイス(デバイス)の一覧を以下に示す (表 3-1)。
表 3-1: インターフェイス一覧
No

インターフェイス名説明

1

ゲートウェイ接続インターフェイス

IoT ゲートウェイ接続を実行するインターフェイス

2

ゲートウェイ切断インターフェイス

IoT ゲートウェイ切断を実行するインターフェイス
即時監視、定周期監視、制御値設定の要求を水道標準

3

要求データ取得共通インターフェイス

プラットフォームより取得する共通インターフェイ
ス

4

即時監視インターフェイス

即時監視を実行するインターフェイス

5

定周期監視インターフェイス

定周期監視を実行するインターフェイス

6

制御値設定インターフェイス

制御値設定を実行するインターフェイス

7

公開鍵証明書ファイル取得インターフェイス

アプリケーション証明書(データ保護用)、水道標準プ
ラットフォーム証明書(データ保護用)を取得するインターフェイス

各インターフェイスの詳細は、4. 章を参照。

18
WPSC003-Ed.1.1 2021-02

3.2 プロトコル
接続方式の前提条件
不正アクセスを防ぐためにファイアウォール機能やパケットフィルタリング機能をもつ
ルータが間に設置されていることを前提とする。
接続方式を以下に示す(図 3-1)。

・誤データを含むアクセ

アプリベンダー向け標準インターフェイスス
誤データ

・悪意のあるユーザーによるアクセス

水道標準プラットフォーム
機器ベンダー向け
標準インターフェイス(デバイス)

蓄積
データ

マスタ
データ

機器ベンダー向け
標準インターフェイス(システム)

インターネット①許可されていない通信はできない
ルーター②IoT ゲートウェイからはアクセスできる

標準インターフェイス
IoT ゲートウェイ

ローカルネットワーク

図 3-1:接続方式

19
WPSC003-Ed.1.1 2021-02

実装仕様のプロトコル
機器ベンダー向け標準インターフェイス(デバイス)で使用するプロトコルを以下に示す(表 3-2)。
表 3-2: 機器ベンダー向け標準インターフェイス(デバイス)のプロトコル
No.

用途

プロトコル

プロトコル説明
水道標準プラットフォームから IoT ゲートウェイへデータ要求を

1

要求データ
取得

行う際に使用するプロトコル。
MQTT SSL

IoT ゲートウェイからアクセスし、水道標準プラットフォームからのデータ要求を受信することが可能。
相互認証として TLS を使用。
IoT ゲートウェイから水道標準プラットフォームへデータ応答を行う際に使用するプロトコル。

2

HTTP(S)

ゲートウェイ接続時に指定される「プロトコル種別」で切り分け。
ファイル等の容量の大きいデータ送信。

応答データ

相互認証として TLS を使用。

送信

IoT ゲートウェイから水道標準プラットフォームへデータ応答を行う際に使用するプロトコル。

3

MQTT SSL

ゲートウェイ接続時に指定される「プロトコル種別」で切り分け。
監視データ等の容量の小さいデータ送信。
相互認証として TLS を使用。

MQTT
要求データ取得の接続手順
水道標準プラットフォームからのデータの要求を受信するための、MQTT の接続シーケン
スを以下に示す(図 3-2)。
IoT ゲートウェイから初期化時に接続する。接続したセッションを保持し、水道標準プラ
ットフォームから送信されるメッセージを MQTT サブスクライバーで受信する。
本項以降の MQTT の詳細フローにおいて、MQTT サブスクライバー、MQTT ブローカーの記
述は省略する。

20
WPSC003-Ed.1.1 2021-02

水道標準プラットフォーム

IoT ゲートウェイ
MQTT
サブスクライバー

MQTT
ブローカー

接続

初期化

接続後、セッション保持
IoT ゲートウェイ毎にトピックを指定データの要求MQTT サブスクライバー

図 3-2: MQTT の接続シーケンス（要求データ取得）

ベース URL とトピックの形式は以下とし、ポート番号は 8883 とする。
MQTT ブローカーの URL
ssl://{水道標準プラットフォームのホスト名}:8883

MQTT サブスクライバーで指定するトピック
定周期開始/pf/gw/[監視要求(定周期)]/start/{テナント ID}/{ゲートウェイ ID}/*
定周期停止/pf/gw/[監視要求(定周期)]/stop/{テナント ID}/{ゲートウェイ ID}/*
制御値設定依頼/pf/gw/[制御値設定]/{テナント ID}/{ゲートウェイ ID}
即時取得依頼/pf/gw/[監視要求(即時)]/{テナント ID}/{ゲートウェイ ID}

水道標準プラットフォームのホスト名はプラットフォーマーが定義する。
応答データ送信の接続手順
IoT ゲートウェイから水道標準プラットフォームへデータの応答送信するための、MQTTの接続シーケンスを以下に示す(図 3-3)。

21
WPSC003-Ed.1.1 2021-02

水道標準プラットフォーム

IoT ゲートウェイ
MQTT
サブスクライバー

MQTT
ブローカー

データ送信
MQTT パブリッシャー
送信するデータ毎にトピックを指定

図 3-3: MQTT の接続シーケンス（応答データ送信）ベース URL とトピックの形式は以下とし、ポート番号は 8883 とする。
MQTT ブローカーの URL
ssl://{水道標準プラットフォームのホスト名}:8883

MQTT パブリッシャーで指定するトピック
応答するデータ毎に以下を指定する。
指定する各トピックの URI については、4.インターフェイス仕様 に記載。

水道標準プラットフォームのホスト名はプラットフォーマーが定義する。

ヘッダ/ボディの定義
MQTT のデータ要求・データ応答のヘッダとボディの設定箇所と形式を以下に示す(図3-4)。MQTT では、プロトコルボティ部にデータ要求・データ応答のヘッダとボティを XML
形式、又は JSON 形式で設定する。
プロトコル ヘッダ
プロトコル ボディ
ヘッダ
(XML or JSON 形式)
ボディ(XML or JSON 形式)
図 3-4： ヘッダ/ボディのプロトコル設定場所と形式(MQTT)22
WPSC003-Ed.1.1 2021-02

HTTP(S)
応答データ送信の接続手順
IoT ゲートウェイから水道標準プラットフォームへデータの応答送信するための、HTTP(S)の接続シーケンスを以下に示す(図 3-5)。

水道標準プラットフォーム

IoT ゲートウェイ

データの応答HTTP(S)リクエスト

HTTP(S)レスポンス

図 3-5： HTTP(S)の接続シーケンス（応答データ送信）ベース URL は以下とし、ポート番号は 443 とする。
https://${水道標準プラットフォームのホスト名}

水道標準プラットフォームのホスト名はプラットフォーマーが定義する。
ヘッダ/ボディの定義
HTTP(S)のデータ要求・データ応答のヘッダとボディの設定箇所と形式を以下に示す(図3-6)。HTTP(S)では、プロトコルヘッダ部にデータ要求のヘッダをプロトコル指定形式で設定し、プロトコルボディ部にデータ応答のボディ部を XML 形式、又は JSON 形式で設定する。

プロトコル ヘッダ
ヘッダ
(プロトコル指定形式)

プロトコル ボディ
ボディ
(XML or JSON 形式)

図 3-6： ヘッダ／ボディのプロトコル設定場所と形式(HTTP(S))

23
WPSC003-Ed.1.1 2021-02基本的な処理の流れとプロトコルの関係
機器ベンダー向け標準インターフェイス(デバイス)では、基本仕様書の 4.1 節に記載されている水道標準プラットフォームと IoT ゲートウェイ間のデータ要求、データ応答の基本的な処理の流れの仕様として、データ要求のプロトコルを MQTT(サブスクライバー)、データ応
答のプロトコルを MQTT(パブリッシャー)、又は HTTP(S)(リクエストとレスポンス)とする。
応答するプロトコルの選択は、IoT ゲートウェイが対応する「ゲートウェイ接続情報のプロパティ」として、ゲートウェイ接続時に水道標準プラットフォームへ通知し、水道標準プ
ラットフォームから応答された「プロトコル種別」にて切り分ける。
データ要求、データ応答の基本的な処理の流れとプロトコルの関係を以下に示す(図 3-7)。

基本的な処理の流れ
水道標準
プラットフォーム

デ
ー
タ
を
参
照
・
取
得

プロトコルによる具体的な処理の流れ

IoT
ゲートウェイ

水道標準
プラットフォーム

IoT
ゲートウェイ

データの要求データの要求機器ベンダー
向け標準インター
フェイス(デバイス)(デバイス)

MQTT サブスクライバー

デ
ー
タ
参
照

機器ベンダー
向け標準インター
フェイス(デバイス)(デバイス)

データの応答【凡例】：標準化対象インターフェイス

MQTT の場合

デ
ー
タ
を
参
照
・
取
得

MQTT パブリッシャー

データの応答データ参照HTTP(S)の場合
HTTP(S)リクエスト
HTTP(S)レスポンス

データの応答図 3-7: 基本的な処理の流れとプロトコルの関係

24
WPSC003-Ed.1.1 2021-02

3.3 セキュリティ
データの漏えいや改ざんを防ぐためには、正しい接続元・接続先との通信が必要である。IoT
ゲートウェイと水道標準プラットフォームの間において、通信の開始時に双方で通信相手の正当性を確認（相互認証）し、通信経路を暗号化する。相互認証と通信経路の暗号化は、水道標
準プラットフォームをサーバー、IoT ゲートウェイをクライアントとして、SSL/TLS の仕様に従って実施する。詳細は、CPS/IoT セキュリティ仕様書の 2.2 節を参照。
通信経路の盗聴だけでなく、水道情報活用システム内での盗聴を防ぐためには、通信経路の暗号化に加えて、データそのものを暗号化する事を検討する必要がある。重要なデータを暗号化することで、流通する経路や一次保存の環境に依らず、データの機密性を確保することが可能となる。また、通信途中でデータの改ざんを検知できるようにするために、やり取りするデータに電子署名を付与し、受信側で検証する仕組みを実装することが望ましい。詳細は、CPS/IoT
セキュリティ仕様書の 2.4 節を参照。また、識別子(ID)や暗号化に利用する鍵情報については、
耐タンパー性を持つ領域に格納し、外部からの不正アクセスや改ざんを防止することで、セキ
ュリティを向上させることが望ましい。
社会インフラ水道情報活用システム標準仕様では、
IoT ゲートウェイからデバイスに対して、制御信号などのデバイスの動作に係わる指示を送ることは、標準仕様として規定しない。
制御信号などを送る場合は、RAS(Reliability、Availability、Serviceability)の観点を十分に考慮した上で、各社の競争領域として設計し、実装すること。

25
WPSC003-Ed.1.1 2021-02

3.4 データの分割送信
IoT ゲートウェイは、メモリ等リソースが限定されることを想定し、水道標準プラットフォー
ムに送信するデータ量が大きい場合、送信データを分割して送信可能とする。分割数はデータ
バイト数・レコード数等データ種別毎に決まった方法で決定する。元データを 2 分割して送信する例を以下に示す(図 3-8)。
水道標準
プラットフォーム

AP
機器ベンダー
向け標準インター
フェイス(デバイス)(デバイス)

④
分割データ
(1)
分割データ
(2)

IoT
ゲートウェイ

データ分割【通番 3 桁-総数 3 桁】
001-002

データの要求MQTT サブスクライバー

デ
ー
タ
を
参
照
・
取
得
・
結
合

②

ヘッダ １/2
デ データの応答 1/2
ー
タ
デ
を
ー
参
タ
照
参
・
照
取
得

①
元データ

ボディ(1)

分割データ(1)

分割データ(2)③
データの応答 2/2

ヘッダ 2/2
ボディ(2)【凡例】：標準化対象インターフェイス【データ応答：HTTP(S)の場合】【データ応答：MQTT の場合】

データの応答

データの応答HTTP(S)リクエスト

MQTT パブリッシャー

HTTP(S)レスポンス

図 3-8: データの分割送信【分割送信の流れ】① 元データを送信するサイズに分割する。
② 分割数(1/2)と分割データ(1)を水道標準プラットフォームに送信する。水道標準プラ
ットフォームは、分割データを AP に送信する。
③ 分割数(2/2)と分割データ(2)を水道標準プラットフォームに送信する。水道標準プラ

26
WPSC003-Ed.1.1 2021-02

ットフォームは、分割データを AP に送信する。
④ AP は、分割数が(2/2)の場合は終了と判断し、分割データを結合する。

27
WPSC003-Ed.1.1 2021-02

3.5 基本的な処理の流れ
本節では、機器ベンダー向け標準インターフェイスの基本的な処理の流れとして以下の 5 つを示す。
・ゲートウェイ接続
・ゲートウェイ切断
・データ操作(参照)プル型
・データ操作(参照)プッシュ型
・データ操作(変更)プル型

ゲートウェイ接続
IoT ゲートウェイは、ゲートウェイ接続情報を水道標準プラットフォームに送信して水道標
準プラットフォームとの接続を確立する。接続により IoT ゲートウェイが提供するデータが水
道標準プラットフォームから利用可能となる。
HTTP(S)を使用したゲートウェイ接続の詳細フローを以下に示す(図 3-9)。

広域向け
アプリケーション

水道標準
プラットフォーム

IoT
ゲートウェイ

デバイス

IoT ゲートウェイ起動
ゲートウェイ接続情報の取得

ゲ
ー
ト
ウ
ェ
イ
接
続

ゲートウェイ接続
HTTP(S)リクエスト
HTTP(S)レスポンス

ゲートウェイ接続情報の送信

接続結果
機器ベンダー向け
標準インターフェイス(デバイス)【凡例】：標準化対象インターフェイス

図 3-9: 詳細フロー(ゲートウェイ接続)

28
WPSC003-Ed.1.1 2021-02

ゲートウェイ切断
既に接続済みの IoT ゲートウェイは、ゲートウェイ切断情報を水道標準プラットフォームに送信して、水道標準プラットフォームとの接続を切断する。切断により IoT ゲートウェイが提供するデータが水道標準プラットフォームから利用不可となる。
HTTP(S)を使用したゲートウェイ切断の詳細フローを以下に示す(図 3-10)。

広域向け
アプリケーション

水道標準
プラットフォーム

ゲ
ー
ト
ウ
ェ
イ
接
続

IoT
ゲートウェイ

デバイス

ゲートウェイ切断
HTTP(S)リクエスト
HTTP(S)レスポンス

ゲートウェイ切断情報の送信

切断結果
機器ベンダー向け
標準インターフェイス(デバイス)

IoT ゲートウェイ終了【凡例】：標準化対象インターフェイス

図 3-10: 詳細フロー(ゲートウェイ切断)

なお、本フローによるものではなく、何らかの異常発生時に水道標準プラットフォーム側との接続が切断されてしまった場合は、再度 3.5.1 のフローにより再接続する必要がある。また切断されてしまった時点から、再度 3.5.1 のフローにより再接続するまでの間に取得すべきだ
ったデータの再送は行われない。

29
WPSC003-Ed.1.1 2021-02

データ操作(追加、変更、削除、参照)
データ操作とは、ユーザーがデバイス・システム、外部サービスのデータを IoT ゲートウ
ェイ、水道標準プラットフォーム及び広域向けアプリケーションを介して、追加、変更、削除、参照する操作である。
データ操作には以下 3 つの処理がある。
・データ操作(参照)プル型
・データ操作(参照)プッシュ型
・データ操作(変更)プル型

30
WPSC003-Ed.1.1 2021-02

データ操作(参照)プル型
MQTT/HTTP(S)を使用したデータ操作(参照)プル型の詳細フローを以下に示す。

広域向け
アプリケーション

ユーザー

水道標準
プラットフォーム

利用アプリケーション実行

IoT
ゲートウェイ
データの受信設定
MQTT サブスクライバー

デバイス

水道標準プラットフォーム起動時にサブスクライブをする

データの要求データ保護用公開鍵
証明書ファイル取得

アプリベンダー
向け標準インターフェイスHTTP(S)リクエスト
HTTP(S) レスポンス 復号

データ保護用公開鍵
証明書ファイル取得
HTTP(S)リクエスト

デ
ー
タ
を
受
信
・
蓄
積

機器ベンダー
向け標準インター
フェイス(デバイス)

デ
ー
タ
参
照

デバイス
インターフェイス

デ
ー
タ
送
信

MQTT の場合

データの応答MQTT パブリッシャー

データの応答HTTP(S)リクエスト
HTTP(S)レスポンス

データの応答
データの表示水道標準プラットフォームのサーバー証明書を保持していた場合は処理をスキップ

HTTP(S) レスポンス

ア
プ
リ
ケ
ー
シ
ョ
ン
上
で
デ
ー
タ
参
照
操
作

データ要求したアプリケーションのアプリケーション証明書を保持していた場合は処理をスキップ

暗
号
化
デ
ー
タ
生
成

加
工

HTTP(S)の場合【凡例】：標準化対象インターフェイス：標準化非対象インターフェイス

図 3-11: 詳細フロー(データ操作(参照)プル型)

31
WPSC003-Ed.1.1 2021-02

データ操作(参照)プッシュ型
MQTT/HTTP(S)を使用したデータ操作(参照)プッシュ型の詳細フローを以下に示す。
広域向け
アプリケーション

ユーザー

IoT
ゲートウェイ

水道標準
プラットフォーム

プッシュ指示の要求

デバイス

プッシュ指示の要求
MQTT サブスクライバー

アプリベンダー
向け標準インターフェイス

データ保護用公開鍵
証明書ファイル取得

データ要求したアプリケーションのアプリケーション証明書を保持していた場合は処理をスキップ

HTTP(S)リクエスト
HTTP(S) レスポンス

デ
ー
タ
要
求

デ
ー
タ

機器ベンダー
向け標準インターフェイス(デバイス)

要求データ保護用公開鍵
証明書ファイル取得
HTTP(S)リクエスト
HTTP(S) レスポンス

水道標準プラットフォームのサーバー証明書を保持していた場合は処理をスキップ

復号

プッシュ指示の応答

MQTT の場合

MQTT パブリッシャー

プッシュ指示の応答

HTTP(S)の場合

HTTP(S)リクエスト
HTTP(S)レスポンス

プッシュ指示の応答
loop

デ
ー
タ
参
照

機器ベンダー
向け標準インターフェイス(デバイス)

デバイス
インターフェイス

イベントデータ

デ
ー
タ
受
信
・
蓄
積
アプリベンダー
向け標準インタ
ーフェイス

デ
ー
タ
送
信

MQTT の場合

MQTT パブリッシャー

暗号(プッシュ通信)化
デー
イベントデータタ
HTTP(S)リクエスト 生
HTTP(S)レスポンス 成

HTTP(S)の場合(プッシュ通信)イベントデータ(プッシュ通信)イベントデータ(プッシュ通信)

【凡例】

加
工

：標準化対象インターフェイス：標準化非対象インターフェイス

図 3-12: 詳細フロー（データ操作(参照)プッシュ型）

32
WPSC003-Ed.1.1 2021-02

データ操作(変更)プル型
MQTT/HTTP(S)を使用したデータ操作(変更)プル型の詳細フローを以下に示す。
広域向け
アプリケーション

ユーザー

水道標準
プラットフォーム

利用アプリケーション実行
制御データの要求
手動による制御要求やアプリケーションの判定によるインターロックのための制御要求を想定

IoT
デバイス
ゲートウェイ
データの受信設定
MQTT サブスクライバー
水道標準プラットフォーム起動時にサブスクライブをする

データ保護用公開鍵
証明書ファイル取得
データ要求したアプリケーションのアプリケーション証明書を保持していた場合は処理をスキップ

HTTP(S)リクエスト

アプリベンダー
向け標準インターフェイス

機器ベンダー
向け標準インター
フェイス(デバイス)

MQTT の場合

制御要求受付の表示

制御開始の表示アプ
リ
HTTP(S)の場合
ケ
ー
シ
ョ
ン
上
で
Ｉ 制御要求受付の応答
ｏ
Ｔ
ゲ
ー
ト
MQTT の場合
ウェイ
へのHTTP(S)の場合
制
御
値
設
定

制御開始の応答

デ
ー
タ
を
参
照
・
取
得

データ保護用公開鍵
証明書ファイル取得
HTTP(S)リクエスト

水道標準プラットフォームのサーバー証明書を保持していた場合は処理をスキップ

HTTP(S) レスポンス
制御要求受付の応答
MQTT パブリッシャー

制
御制御要求受付の応答 要
求HTTP(S)リクエスト
受
付
HTTP(S レスポンス

加
工

デ
バ
イ
ス
通
知
を
受
信

制御開始の応答MQTT パブリッシャー
制御開始の応答HTTP(S)リクエスト
HTTP(S レスポンス

デバイス
インターフェイス

制
御
要
求
送
信

制
御
開
始

暗
号
化
デ
ー
タ
生
成
制
御
結
果
受
信

加
工

制
御
完
了

制御結果の応答MQTT の場合

HTTP(S)の場合

HTTP(S) レスポンス 復
号

制
御
結
果
を
受
信

MQTT パブリッシャー
制御結果の応答HTTP(S)リクエスト
HTTP(S レスポンス

暗
号
化
デ
ー
タ
生
成
【凡例】

制御結果の表示

制御結果の応答加工：標準化対象インターフェイス：標準化非対象インターフェイス

図 3-13: 詳細フロー（データ操作(変更)プル型）
33
WPSC003-Ed.1.1 2021-02

4. インターフェイス仕様
本章では、水道情報活用システムがサポートする各インターフェイスについて以下を示す。
・HTTP(S)プロトコルにおける要求と応答の詳細フローとパラメーター
・MQTT プロトコルにおけるデータ要求の詳細とパラメーター
但し、インターフェイスによっては指定するデータ項目が異なる。

34
WPSC003-Ed.1.1 2021-02

4.1 ゲートウェイ接続インターフェイス
ゲートウェイ接続インターフェイスはゲートウェイ接続を通知する。ゲートウェイ接続ではHTTP(S)プロトコルを利用する。
ゲートウェイ接続における詳細フローとパラメーター
HTTP(S)の詳細フロー及びパラメーターを示す。
詳細フロー
ゲートウェイ接続の詳細フローを以下に示す(図 4-1)。

広域向け
アプリケーション

水道標準
プラットフォーム

IoT
ゲートウェイ

デバイス

IoT ゲートウェイ起動
ゲートウェイ接続データの取得

ゲ
ー
ト
ウ
ェ
イ
接
続

ゲートウェイ接続
HTTP(S)リクエスト(ゲートウェイ接続)
HTTP(S)レスポンス(ゲートウェイ接続の通信結果)

ゲートウェイ接続情報の送信

接続結果
機器ベンダー向け
標準インターフェイス(デバイス)【凡例】：標準化対象インターフェイス

図 4-1: ゲートウェイ接続の詳細フローリクエスト（要求情報）のパラメーター
HTTP(S)でゲートウェイ接続情報を IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す(表 4-1)。
表 4-1: HTTP(S)リクエストのパラメーター（ゲートウェイ接続）

No.
1
2
3

種

(データ項目)

別

名称

リ
ク
エ
ス

HTTP メソッド
パス（URL）
プロトコルバージョン

必須/
説明

任意/

書式

不要
“POST”固定"/sbi/v1/device_info/connection/"

固定"HTTP1.1"固定

必須

文字列

必須

文字列

必須

文字列

35
WPSC003-Ed.1.1 2021-02

No.

4

種

(データ項目)

別

名称

ト
行

文字コード

必須/
説明

任意/

書式

不要
utf-8

必須

文字列

必須

文字列

必須

文字列

不要

文字列

必須

文字列

必須

文字列

不要

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

データ種別 ID の項目一覧から"接続情5(データ種別 ID)

報"を指定する。基本仕様書の 4.4.1 項

X-CPS-dataTypeIdを参照。
(0000000100000000 を指定)

(操作種別 ID)

6ヘ

7

X-CPS-Operation

ッ(依頼元情報)ダ

X-CPS-Source-ID(入力形式)

8

Content-type(タイムスタンプ)

9

X-CPS-Timestamp(要求 ID)10

X-CPS-monitoringRequestId

操作種別 ID の項目一覧から"POST"を指定する。基本仕様書の 4.4.2 項を参照。(“POST”を指定)(なし)
以下のいずれかを指定。
・"application/xml;charset=utf-8"
・"application/json"
ISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(リクエスト時刻)を指定)(なし)(ゲートウェイ接続プロパテ

11

ィ)accessInformation(ゲートウェイ ID)

12

gwId
(ゲートウェイ名)

13
ボ

14

デ
ィ

15

ゲートウェイ ID を設定

ゲートウェイ名を設定

gwName(ゲートウェイ種別)

以下のいずれかを指定。

gwKind・IoT ゲートウェイの場合："IoTGw"(事業体ＩＤ)

ゲートウェイが所属する事業体 ID を

corporationId

設定(インターフェイスバー ゲートウェイで利用可能な GW 向け標

16

17

ジョン)

準インターフェイスのバージョンを

ifVersion

設定(対応データ種別)

ゲートウェイで利用可能なデータ種

dataTypeId

別 ID をカンマ区切りで設定
36

WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)別名称(対応データ種別

18

必須/
説明

任意/

書式

不要
プラ データ種別のデータを一意に特定す

イマリーキープロパティ るプロパティ名を設定
名)

必須

文字列

必須

文字列

必須

文字列

dataTypeKey
IoT ゲートウェイが水道標準プラット

19(プロトコル種別)
protocol

フォームに対して、送信する時の通信プロトコルを指定。
・MQTT："MQTT"・HTTP(S)："HTTP"

20(対応コンテンツタイプ)

ゲートウェイで利用可能なコンテン

contentType

ツタイプをカンマ区切りで設定

37
WPSC003-Ed.1.1 2021-02

レスポンス(応答情報)のパラメーター
HTTP(S)でゲートウェイ接続の通信結果を水道標準プラットフォームから IoT ゲート
ウェイに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す（表4-2）。
表 4-2 HTTP(S)レスポンスのパラメーター（ゲートウェイ接続）
No.

種(データ項目)別名称レポ (ステータスコード)
ン Status Codeス

(データ種別 ID)
X-CPS-dataTypeId(操作種別 ID)

3
4
5

任意/

X-CPS-Operation(依頼元情報)ヘ X-CPS-Source-ID

不要

異常(不正要求):400
異常(登録されていない GW):401"0000000100000000"固定

必須"POST"固定必須"NULL"固定不要

リクエスト時の「入力形式」で指定

ダ Content-type

した内容(タイムスタンプ)
X-CPS-Timestamp(要求 ID)

7

必須

異常(指定したリソースが見つからッ (出力形式)

6

書式

文 字
列

ない):404)

行

2

説明

正常終了:200

ス

1

必須/

X-CPS-monitoringRequestId)

必須

ISO8601 に従って応答時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ

必須(生成日時(レスポンス時刻)を指定)"NULL"固定

不要

文 字
列
文 字
列
文 字
列
文 字
列
文 字
列
文 字
列

【正常の時】(ゲートウェイ接続プロパテ
ィ)
ボ

8

デ
ィ

ボディ包括タグ

accessInformation(ゲートウェイ ID)

ゲートウェイ ID を設定

必須

gwId
(ゲートウェイ名)

ゲートウェイ名を設定

必須

gwName(ゲートウェイ種別)

以下のいずれかを指定。

gwKind・IoT ゲートウェイの場合:"IoTGw"

必須

文 字
列
文 字
列
文 字
列

38
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/
不要

(事業体ＩＤ)

ゲートウェイが所属する事業体 ID

corporationIdを設定(インターフェイスバー

ゲートウェイで利用可能な GW 向け

ジョン)

標準インターフェイスのバージョン

ifVersion

を設定(対応データ種別)

ゲートウェイで利用可能なデータ種

dataTypeId

別 ID をカンマ区切りで設定(対応データ種別

書式

必須

必須

必須

文 字
列
文 字
列
文 字
列

プラ データ種別のデータを一意に特定す

イマリーキープロパテ

るプロパティ名を設定

必須

ィ名)

文 字
列

dataTypeKey
ゲートウェイ接続のリクエスト時に通知し、水道標準プラットフォーム(プロトコル種別)に登録された通信プロトコルを設

protocol

定。

必須

文 字
列

・MQTT："MQTT"・HTTP(S)："HTTP"( ア ク セ ス 先 ホ ス ト 名 ゲートウェイが定周期監視の用途で[定周期監視])サブスクライブする接続先

必須

文 字
列

monitoring(アクセス先ホスト名[即時取得])

ゲートウェイが即時取得の用途でサ
ブスクライブする接続先

必須

文 字
列

immediateAcquisition(アクセス先ホスト名[制御値設定])

ゲートウェイが制御値設定の用途でサブスクライブする接続先

必須

文 字
列

deviceControl( 対 応 コ ン テ ン ツ タ イ ゲートウェイで利用可能なコンテン
プ)ツタイプをカンマ区切りで設定

必須

contentType【異常の時】

9(メッセージ)
message

文 字列

任意のエラーメッセージ。
・アプリベンダー向け標準インターフェイス仕様書 3.5.1「メッセージ

必須

文 字
列

仕様」に準拠する。

39
WPSC003-Ed.1.1 2021-02

4.2 ゲートウェイ切断インターフェイス
ゲートウェイ切断インターフェイスはゲートウェイ切断を通知する。
ゲートウェイ切断では HTTP(S)プロトコルを利用する。
ゲートウェイ切断における詳細フローとパラメーター
HTTP(S)の詳細フロー及びパラメーターを示す。
詳細フロー
ゲートウェイ切断の詳細フローを以下に示す(図 4-2)。

広域向け
アプリケーション

水道標準
プラットフォーム

IoT
ゲートウェイ

デバイス

IoT ゲートウェイ終了処理

ゲ
ー
ト
ウ
ェ
イ
切
断

ゲートウェイ切断
HTTP(S)リクエスト(ゲートウェイ切断)
HTTP(S)レスポンス(ゲートウェイ切断の通信結果)

ゲートウェイ切断情報の送信

切断結果
IoT ゲートウェイ終了

機器ベンダー向け
標準インターフェイス(デバイス)【凡例】：標準化対象インターフェイス

図 4-2: ゲートウェイ切断の詳細フローリクエスト（要求情報）のパラメーター
HTTP(S)でゲートウェイ切断情報を IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す（表 4-3）。
表 4-3: HTTP(S)リクエストのパラメーター（ゲートウェイ切断）

No.
1
2
3

種

(データ項目)

別

名称

リ
ク
エ
ス

HTTP メソッド
パス（URL）
プロトコルバージョン

必須/
説明

任意/

書式

不要
“POST”固定"/sbi/v1/device_info/disconnect/"

固定"HTTP1.1"固定

必須

文字列

必須

文字列

必須

文字列

40
WPSC003-Ed.1.1 2021-02

No.

4

種

(データ項目)

別

名称

ト
行

文字コード

必須/
説明

任意/

書式

不要
utf-8

必須

文字列

必須

文字列

必須

文字列

不要

文字列

必須

文字列

必須

文字列

不要

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

データ種別 ID の項目一覧から"接続情5(データ種別 ID)

報"を指定する。基本仕様書の 4.4.1 項

X-CPS-dataTypeIdを参照。
(0000000100000000 を指定)
操作種別 ID の項目一覧から"DELETE"

6

ヘ

7

ッ
ダ

(操作種別 ID)を指定する。基本仕様書の 4.4.2 項を

X-CPS-Operation

参照。
(“DELETE”を指定)(依頼元情報)X-CPS-Source-ID(入力形式)

8

Content-type(タイムスタンプ)

9

X-CPS-Timestamp(要求 ID)10

X-CPS-monitoringRequestId(なし)
以下のいずれかを指定。
・"application/xml;charset=utf-8"
・"application/json"
ISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(リクエスト時刻)を指定)(なし)(ゲートウェイ接続プロパテ

11

ィ)accessInformation(ゲートウェイ ID)

12
13

gwId
(ゲートウェイ名)
ボ
デ

14

15

ゲートウェイ ID を設定

ィ

ゲートウェイ名を設定

gwName(ゲートウェイ種別)
gwKind以下のいずれかを指定。
・ＩｏＴゲートウェイの場合："IoTGw"(事業体ＩＤ)

ゲートウェイが所属する事業体 ID を

corporationId

設定(インターフェイスバー ゲートウェイで利用可能な GW 向け標

16

ジョン)

準インターフェイスのバージョンを

ifVersion

設定
41
WPSC003-Ed.1.1 2021-02

No.

17

種

(データ項目)

別

名称

説明

任意/

書式

不要

(対応データ種別)

ゲートウェイで利用可能なデータ種

dataTypeId

別 ID をカンマ区切りで設定(対応データ種別

18

必須/

必須

文字列

必須

文字列

必須

文字列

必須

文字列

プラ データ種別のデータを一意に特定す

イマリーキープロパティ るプロパティ名を設定
名)
dataTypeKey
水道標準プラットフォームを通信す

19(プロトコル種別)るプロトコルを指定

protocol・MQTT："MQTT"・HTTP(S)："HTTP"

20(対応コンテンツタイプ)

ゲートウェイで利用可能なコンテン

contentType

ツタイプをカンマ区切りで設定

42
WPSC003-Ed.1.1 2021-02

レスポンス(応答情報)のパラメーター
HTTP(S)でゲートウェイ切断の通信結果を水道標準プラットフォームから IoT ゲート
ウェイに返却する。
その際の HTTP(S)レスポンスのパラメーターを以下に示す（表 4-4）。
表 4-4: HTTP(S)レスポンスのパラメーター（ゲートウェイ切断）

No.

種(データ項目)

別

名称

レ

ポ

(ステータスコード)

ン

Status Codeス

(データ種別 ID)
X-CPS-dataTypeId(操作種別 ID)

3
4
5

任意/

X-CPS-Operation(依頼元情報)不要

異常(不正要求):400
異常(登録されていない GW):401

必須

文字列

"0000000100000000"固定

必須

文字列

"DELETE"固定

必須

文字列

"NULL"固定

不要

文字列

必須

文字列

必須

文字列

"NULL"固定

不要

文字列

空文字

必須

文字列

必須

文字列

異常(指定したリソースが見つからヘ

X-CPS-Source-ID

ッ(出力形式)

リクエスト時の「入力形式」で指定

ダ

Content-type

した内容(タイムスタンプ)

6

X-CPS-Timestamp(要求 ID)

7

書式ない):404)

行

2

説明

正常終了:200

ス

1

必須/

X-CPS-monitoringRequestId)

ISO8601 に従って応答時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(レスポンス時刻)を指定)【正常の時】

8

9(レスポンス)ボ

response

デ【異常の時】

ィ(メッセージ)
message

任意のエラーメッセージ。
・アプリベンダー向け標準インターフェイス仕様書 3.5.1「メッセージ仕様」に準拠する。

43
WPSC003-Ed.1.1 2021-02

4.3 要求データ取得共通インターフェイス
要求データ取得共通インターフェイスは、アプリケーションの起動時に即時監視、定周期監
視、制御値設定の要求内容を水道標準プラットフォームから MQTT トピックとしてサブスクライ
バーされて IoT ゲートウェイへ通知される共通インターフェース。
要求データ取得における詳細フローとパラメータ
即時監視、定周期監視、制御値設定の要求データの取得における MQTT サブスクライバーの詳細フロー及びパラメーターを以下に示す。
詳細フロー
要求データ取得の詳細フローを以下に示す(図 4-3)。
また、データの分割送信時の要求データ取得の詳細フローについては、3.4 を参照。

水道標準プラットフォーム

IoT ゲートウェイ
MQTT
サブスクライバー

MQTT
ブローカー

接続

初期化

接続後、セッション保持
IoT ゲートウェイ毎にトピックを指定データの要求MQTT サブスクライバー

図 4-3: MQTT の接続シーケンス（要求データ受信）

要求データの取得パラメーター(定周期)① MQTT 接続パラメーター(トピック)
MQTT の接続パラメーターを以下に示す（表 4-5）。
表 4-5: MQTT の接続パラメーター(定周期)
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック

/gw/pf/[監視要求(定周期)]/{テナント ID}/*/*

3

文字コード

utf-8

44
WPSC003-Ed.1.1 2021-02

② MQTT サブスクライバー(要求データ取得)
MQTT サブスクライバーとして水道標準プラットフォームから IoT ゲートウェイへ通知される要求データを以下に示す（表 4-6）。
表 4-6: MQTT サブスクライバー（要求データ取得）のパラメーター(定周期)No.

種(データ項目)別名称(インターフェイス包括タグ)

1

CPS-IfElement(ヘッダ包括タグ)

2

CPS-IfHeader

必須/
説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID が指定される。

3(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

X-CPS-dataTypeId

・監視要求(定周期)：

必須

文字列

必須

文字列

必須

文字列

必須

文字列

"0200000200000000"(操作種別 ID)

4

X-CPS-Operation
プ

5

6

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・定周期監視要求："GET"ID 種別、アプリケーション ID が指ロ(依頼元情報)定される。

ト

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

コ("03-[アプリケーション ID]")

ル

IANA に登録された MIME タイプを

ボ

(入出力形式)指定。以下のいずれかが指定。

デContent-type

・"application/xml;charset=utf-8"

ィ・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。
通番 3 桁-総数 3 桁

記載例:002-

003

必須/
任意

文字列

データ分割については、3.4 節参照。
ISO8601 に従って要求時刻を指定
8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

定)
45
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

書式

不要

【監視要求の時】
9

任意/

即時監視、定周期監視の要求時に指定。

(監視要求 ID)

求時に監視要求を一意に示す ID

X-CPS-monitoringRequestId

監視要
文字列

必須

制御要求時に必須
0:正常終了

10(実行結果コード)

1:不正業務アクティビティ有り

X-CPS-Result

101:データプロファイル生成異常

必須

文字列

必須

文字列

999:その他異常
11

ボディ包括タグCPS-IfBody

要求データのデータプロファイル
12(業務アクティビティ群)

詳細は、水道 CPS データプロファ

Activities

イル仕様書の 2.4.1 項、2.4.2 項を参照。

要求データの取得パラメーター(即時)① MQTT 接続パラメーター(トピック)
MQTT の接続パラメーターを以下に示す（表 4-7）。
表 4-7: MQTT の接続パラメーター(即時)
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック

/gw/pf/[監視要求(即時)]/{テナント ID}/*

3

文字コード

utf-8

46
WPSC003-Ed.1.1 2021-02

② MQTT サブスクライバー(要求データ取得)
MQTT サブスクライバーとして水道標準プラットフォームから IoT ゲートウェイへ通知される要求データを以下に示す（表 4-8）。
表 4-8: MQTT サブスクライバー（要求データ取得）のパラメーター(即時)No.

種(データ項目)別名称(インターフェイス包括タグ)

1

CPS-IfElement(ヘッダ包括タグ)

2

CPS-IfHeader

必須/
説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID が指定される。

(データ種別 ID)

3

X-CPS-dataTypeId

基本仕様書の 4.4.1 項を参照。
・監視要求(即時)：

必須

文字列

必須

文字列

必須

文字列

必須

文字列

"0200000100000000"

操作種別 ID が指定される。
4

プ(操作種別 ID)

基本仕様書の 4.4.2 項を参照。

ロ

X-CPS-Operation

・即時監視要求："GET"

ト
コ
5

6

ID 種別、アプリケーション ID が指ル(依頼元情報)定される。

ボ

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

デ("03-[アプリケーション ID]")

ィ

IANA に登録された MIME タイプを(入出力形式)指定。以下のいずれかが指定。

Content-type

・"application/xml;charset=utf-8"
・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。
通番 3 桁-総数 3 桁

記載例:002-

003

必須/
任意

文字列

データ分割については、3.4 節参照。

47
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
ISO8601 に従って要求時刻を指定

8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

定)
【監視要求の時】
9(監視要求 ID)
X-CPS-monitoringRequestId

10(ゲートウェイ ID)
X-CPS-GatewayId

即時監視、定周期監視の要求時に
指定。

監視要
求時に

監視要求を一意に示す ID

文字列

必須

制御要求時に必須
リクエスト時のゲートウェイ ID

必須

文字列

必須

文字列

必須

文字列

0:正常終了
11(実行結果コード)

1:不正業務アクティビティ有り

X-CPS-Result

101:データプロファイル生成異常
999:その他異常

12CPS-IfBody

ボディ包括タグ

要求データのデータプロファイル
13(業務アクティビティ群)

詳細は、水道 CPS データプロファ

Activities

イル仕様書の 2.4.1 項、2.4.2 項を参照。

48
WPSC003-Ed.1.1 2021-02

要求データの取得パラメーター(制御要求送信結果)① MQTT 接続パラメーター(トピック)
MQTT の接続パラメーターを以下に示す（表 4-9）。
表 4-9: MQTT の接続パラメーター(制御要求送信結果)
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック

/gw/pf/[制御値設定]/sending_result/{テナント ID}/*

3

文字コード

utf-8

49
WPSC003-Ed.1.1 2021-02

② MQTT サブスクライバー(要求データ取得)
MQTT サブスクライバーとして水道標準プラットフォームから IoT ゲートウェイへ通知される要求データを以下に示す（表 4-10）。
表 4-10: MQTT サブスクライバー（要求データ取得）のパラメーター(制御要求送信結果)
No.

種(データ項目)別名称(インターフェイス包括タグ)

1

CPS-IfElement(ヘッダ包括タグ)

2

CPS-IfHeader

必須/
説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID が指定される。

3(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

X-CPS-dataTypeId

・制御値設定：

必須

文字列

必須

文字列

必須

文字列

必須

文字列

"0200000600000000"(操作種別 ID)

4

X-CPS-Operation
プ

5

6

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・制御値設定要求："PUT"ID 種別、アプリケーション ID が指ロ(依頼元情報)定される。

ト

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

コ("03-[アプリケーション ID]")

ル

IANA に登録された MIME タイプを指ボ(入出力形式)定。以下のいずれかが指定。

デContent-type

・"application/xml;charset=utf-8"

ィ・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。
通番 3 桁-総数 3 桁

記載例:002-

003

必須/
任意

文字列

データ分割については、3.4 節参照。
ISO8601 に従って要求時刻を指定
8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

定)
50
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)別

名称【制御要求の時】9(制御要求 ID)

必須/
説明

任意/

書式

不要
制御値設定の要求時に指定。
制御要求を一意に示す ID

制御要
求時に

文字列

必須

X-CPS-controlRequestId

0:正常終了
10(実行結果コード)

1:不正業務アクティビティ有り

X-CPS-Result

101:データプロファイル生成異常

必須

文字列

必須

文字列

999:その他異常
1112

CPS-IfBody(制御要求送信結果)
resultボディ包括タグ
OK、NG

51
WPSC003-Ed.1.1 2021-02

③ MQTT サブスクライバー(要求データ取得)
MQTT サブスクライバーとして水道標準プラットフォームから IoT ゲートウェイへ通知される要求データを以下に示す（表 4-11）。
表 4-11: MQTT サブスクライバー（要求データ取得）のパラメーター(制御要求結果)
No.

種(データ項目)別名称(インターフェイス包括タグ)

1

CPS-IfElement(ヘッダ包括タグ)

2

CPS-IfHeader

必須/
説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID が指定される。

3(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

X-CPS-dataTypeId

・制御値設定：

必須

文字列

必須

文字列

必須

文字列

必須

文字列

"0200000600000000"(操作種別 ID)

4

X-CPS-Operation
プ

5

6

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・制御値設定要求："PUT"ID 種別、アプリケーション ID が指ロ(依頼元情報)定される。

ト

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

コ("03-[アプリケーション ID]")

ル

IANA に登録された MIME タイプを

ボ

(入出力形式)指定。以下のいずれかが指定。

デContent-type

・"application/xml;charset=utf-8"

ィ・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。
通番 3 桁-総数 3 桁

記載例:002-

003

必須/
任意

文字列

データ分割については、3.4 節参照。
ISO8601 に従って要求時刻を指定
8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

定)
52
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)別

名称【制御要求の時】9(制御要求 ID)

必須/
説明

任意/

書式

不要
制御値設定の要求時に指定。
制御要求を一意に示す ID

制御要
求時に

文字列

必須

X-CPS-controlRequestId

0:正常終了
10(実行結果コード)

1:不正業務アクティビティ有り

X-CPS-Result

101:データプロファイル生成異常

必須

文字列

必須

文字列

999:その他異常
11

CPS-IfBody

ボディ包括タグ

要求データのデータプロファイル
12(業務アクティビティ群)

詳細は、水道 CPS データプロファ

Activities

イル仕様書の 2.4.1 項、2.4.2 項を参照。

53
WPSC003-Ed.1.1 2021-02

要求データの取得パラメーター(制御値設定結果)① MQTT 接続パラメーター(トピック)
MQTT の接続パラメーターを以下に示す（表 4-12）。
表 4-12: MQTT の接続パラメーター(制御値設定結果)
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック

/gw/pf/[制御値設定]/manipulation_result/{テナント ID}/*

3

文字コード

utf-8

54
WPSC003-Ed.1.1 2021-02

② MQTT サブスクライバー(要求データ取得)
MQTT サブスクライバーとして水道標準プラットフォームから IoT ゲートウェイへ通知される要求データを以下に示す（表 4-13）。
表 4-13: MQTT サブスクライバー（要求データ取得）のパラメーター(制御値設定結果)
No.

種(データ項目)別名称(インターフェイス包括タグ)

1

CPS-IfElement(ヘッダ包括タグ)

2

CPS-IfHeader

必須/
説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID が指定される。

3(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

X-CPS-dataTypeId

・制御値設定：

必須

文字列

必須

文字列

必須

文字列

必須

文字列

"0200000600000000"(操作種別 ID)

4

X-CPS-Operation
プ

5

6

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・制御値設定要求："PUT"ID 種別、アプリケーション ID が指ロ(依頼元情報)定される。

ト

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

コ("03-[アプリケーション ID]")

ル

IANA に登録された MIME タイプを

ボ

(入出力形式)指定。以下のいずれかが指定。

デContent-type

・"application/xml;charset=utf-8"

ィ・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。
通番 3 桁-総数 3 桁

記載例:002-

003

必須/
任意

文字列

データ分割については、3.4 節参照。
ISO8601 に従って要求時刻を指定
8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

定)
55
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)別

名称【制御要求の時】9(制御要求 ID)

必須/
説明

任意/

書式

不要
制御値設定の要求時に指定。
制御要求を一意に示す ID

制御要
求時に

文字列

必須

X-CPS-controlRequestId

0:正常終了
10(実行結果コード)

1:不正業務アクティビティ有り

X-CPS-Result

101:データプロファイル生成異常

必須

文字列

必須

文字列

999:その他異常
11

CPS-IfBody

ボディ包括タグ
要求データのデータプロファイル

12(業務アクティビティ群)

詳細は、水道 CPS データプロファ

Activities

イル仕様書の 2.4.1 項、2.4.2 項を参照。

56
WPSC003-Ed.1.1 2021-02

4.4 即時監視インターフェイス
即時監視インターフェイスは、データ操作(参照)プル型を使用する。詳細は、図 3-11 を参照。
データ応答のレスポンスに使用するプロトコルは、MQTT/HTTP(S)を利用する。
即時監視における詳細フローとパラメーター
即時監視の要求データの取得、即時監視データ応答における MQTT/HTTP(S)の詳細フロー及びパラメーターを以下に示す。
詳細フロー
即時監視の詳細フローは、前述(3.5.3 項の(1))を参照。
要求データ取得のパラメーター
MQTT サブスクライバーにより、要求データを取得する。
4.3 要求データ取得共通インターフェイスを参照。
HTTP(S)によるデータ応答のパラメーター
即時監視データを水道標準プラットフォームへ応答する場合に使用するプロトコルは、
HTTP(S)と MQTT の場合がある。
以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル
種別：protocol」を参照し、HTTP(S)によるデータ応答のパラメータを記載する。

① HTTP(S)リクエスト(データ応答) のパラメーター
HTTP(S)でデータ応答を IoT ゲートウェイから水道標準プラットフォームに送信する。
その際の HTTP(S)リクエストのパラメーターを以下に示す。
表 4-14: HTTP(S)リクエストのパラメーター（即時監視/データ応答）

No.
1
2
3
4

種

(データ項目)

別

名称

リ
ク
エ
ス
ト
行

HTTP メソッド
パス（URL）

必須/
説明

任意/

書式

不要
“POST”固定"/sbi/v1/immediate_acquisition/re
sult/"固定

必須

文字列

必須

文字列

プロトコルバージョン"HTTP1.1"固定

必須

文字列

文字コード

utf-8

必須

文字列

57
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
データ種別 ID の項目一覧から"監視要5(データ種別 ID)

求（即時）"を指定する。基本仕様書のX-CPS-dataTypeId

4.4.1 項を参照。

必須

文字列

定する。
基本仕様書の 4.4.2 項を参照。 必須

文字列(0200000100000000 を指定)
(操作種別 ID)

6

X-CPS-Operation

操作種別 ID の項目一覧から"GET"を指(“GET”を指定)
ID 種別の項目一覧から"ID 種別"、"ア7(依頼元情報)プリケーション ID "を指定する。基本

X-CPS-Source-ID

仕様書の 4.4.3 項を参照。

必須

文字列

必須

文字列

("03-[アプリケーション ID]"を指定)
以下のいずれかを指定。
【XML 形式の場合】

8(入力形式)

・"application/xml;charset=utf-8"

Content-type【JSON 形式の場合】
・"application/json"

ヘ

9

ッ

・データを分割しない場合は指定不ダ要。
(データ分割)X-CPS-Data-Split

・データを分割した場合は必須とし、以下を指定する。

必須/
任意

通番 3 桁-総数 3 桁

文字列

記載例:002-003
データ分割については、3.4 節参照。

10

11
12

(タイムスタンプ)
X-CPS-Timestamp(監視要求 ID)
X-CPS-monitoringRequestId(ゲートウェイ ID)
X-CPS-GatewayId

ISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ

必須

文字列

監視要求を一意に示す ID

必須

文字列

リクエスト時のゲートウェイ ID

必須

文字列

必須

文字列

(生成日時(リクエスト時刻)を指定)

正常終了:013(実行結果コード)

不正業務アクティビティ有り:1

X-CPS-Result

データプロファイル生成異常:101
その他異常:999
58

WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

ボ

14

デ
ィ

必須/
説明

任意/

書式

不要
即時監視データのプロパティ(業務アクティビティ群)

詳細は、水道 CPS データプロファイ

Activities

ル仕様書の 2.4.1 項、2.4.2 項を参

必須

文字列

照。

② HTTP(S)レスポンス(データ応答の通信結果)のパラメーター
HTTP(S)でデータ応答の通信結果を水道標準プラットフォームから IoT ゲートウェ
イに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す(
表 4-15)。
表 4-15: HTTP(S)レスポンスのパラメーター
No

種(データ項目)

.

別

名称

1

必須/
説明

任意/

書式

不要
正常終了:200(ステータスコード)
Status Code

異常(不正要求):400
異常(認識されていない):401

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

異常(指定したリソースが見つからない):404

2

3

4

5

(データ種別 ID)

リクエスト時のデータが格納

X-CPS-dataTypeId"0200000100000000"固定(操作種別 ID)

リクエスト時のデータが格納

X-CPS-Operation“GET”固定ヘ (依頼元情報)

リクエスト時のデータが格納

ッ X-CPS-Source-ID"03-[アプリケーション ID]"を指定

ダリクエスト時のデータが格納(入出力形式)

以下のいずれかを指定。

Content-type

・"application/xml;charset=utf-8"
・"application/json"

67(データ分割)リクエスト時のデータが格納

必須/

X-CPS-Data-Split"[通番 3 桁数字]-[総数 3 桁数字]"

任意

生成日時(レスポンス時刻)を指定

必須

文字列

リクエスト時の要求 ID が格納

必須

文字列

(タイムスタンプ)
X-CPS-Timestamp

8(監視要求 ID)
X-CPS-monitoringRequestId

文字列59
WPSC003-Ed.1.1 2021-02

No

種(データ項目)

.

別

名称

9

必須/
説明

任意/

書式

不要

【正常時の時】(レスポンス)
ボ

空文字

必須

文字列

必須

文字列

response

デ 【異常の時】

任意のエラーメッセージ。

ィ・アプリベンダー向け標準インター(メッセージ)
message

フェイス仕様書 3.5.1「メッセージ仕様」に準拠する。

60
WPSC003-Ed.1.1 2021-02

MQTT によるデータ応答のパラメーター
即時監視データを水道標準プラットフォームへ応答する場合に使用するプロトコルは、
HTTP(S)と MQTT の場合がある。
以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル
種別：protocol」を参照し、MQTT によるデータ応答のパラメータを記載する。

① MQTT パブリッシュの接続パラメーター
MQTT パブリッシュの接続パラメーターを以下に示す。
表 4-16: MQTT パブリッシュの接続パラメーター
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック"/gw/pf/[監視要求(即時)]/{テナント ID}/{ゲートウエイ ID}"

3

文字コード

utf-8

② MQTT パブリッシュ(データ応答) のパラメーター
MQTT パブリッシャーにて、データ応答の内容を IoT ゲートウェイから水道標準プラッ
トフォームに送信する。その際の MQTT パブリッシュのパラメーターを以下に示す。
表 4-17: MQTT パブリッシュのパラメーター（即時監視/データ応答）
No.

種(データ項目)別名称(インターフェイス包括タグ)

1
プ
2

ロ
ト
コ

3

ル
ボ

CPS-IfElement(ヘッダ包括タグ)
CPS-IfHeader

4

説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID を指定。

(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

X-CPS-dataTypeId

・監視要求(即時)：

必須

文字列

必須

文字列

"0200000100000000"

デ
ィ

必須/

(操作種別 ID)
X-CPS-Operation

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・即時監視要求："GET"61
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
ID 種別、アプリケーション ID が指5(依頼元情報)定される。

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

必須

文字列

必須

文字列

("03-[アプリケーション ID]")
IANA に登録された MIME タイプを指定。以下のいずれかが指定。
6(入出力形式)【XML 形式の場合】

Content-type

・"application/xml;charset=utf-8"【JSON 形式の場合】
・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。

必須/

通番 3 桁-総数 3 桁

任意

記載例:002-003

文字列

データ分割については、3.4 節参照。
ISO8601 に従って要求時刻を指定
8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

監視要求を一意に示す ID

必須

文字列

リクエスト時のゲートウェイ ID

必須

文字列

必須

文字列

詳細は、水道 CPS データプロファイ 必須

文字列

定)
9

10

(監視要求 ID)
X-CPS-monitoringRequestId(ゲートウェイ ID)
X-CPS-GatewayId

正常終了:0
11(実行結果コード)

不正業務アクティビティ有り:1

X-CPS-Result

データプロファイル生成異常:101
その他異常:999

12

CPS-IfBody

ボディ包括タグ
即時監視データのデータプロファ

13(業務アクティビティ群)
Activities

イルル仕様書の 2.4.1 項、2.4.2 項を参照。
62
WPSC003-Ed.1.1 2021-02

4.5 定周期監視インターフェイス
定周期監視インターフェイスは、データ操作(参照)プッシュ型を使用する。
定周期監視には、開始から一定間隔でプッシュするイベントと状態変化/異常値を検知した場合に、一定間隔とは関係なくプッシュするイベントがある。定周期監視停止後は、上記のイベントは発生しない。定周期監視では、MQTT/HTTP(S)プロトコルを利用する。
定周期監視インターフェイスにおける詳細フローとパラメーター
定周期監視のプッシュ指示の要求、プッシュ指示の応答、イベントデータにおける
MQTT/HTTP(S)の詳細フロー及びパラメーターを示す。
詳細フロー
定周期監視の詳細フローは、前述(3.5.3 項の(2))を参照。
要求データ取得のパラメーター
MQTT サブスクライバーにより、要求データを取得する。
4.3 要求データ取得共通インターフェイスを参照。
HTTP(S)(プッシュ指示の応答)のパラメーター
定周期監視データを水道標準プラットフォームへ応答する場合に使用するプロトコルは、
HTTP(S)と MQTT の場合がある。
以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル
種別：protocol」を参照し、HTTP(S)によるデータ応答のパラメータを記載する。

① HTTP(S)リクエスト(プッシュ指示の応答) のパラメーター
HTTP(S)でプッシュ指示の応答を IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す(表 4-18)。
表 4-18: HTTP(S)リクエストのパラメーター（定周期監視/プッシュ指示の応答）

No.
1
2
3

種

(データ項目)

別

名称

必須/
説明
“POST”固定ク"/sbi/v1/monitoring/エ

ス プロトコルバージョン

書式不要

リ HTTP メソッド
パス（URL）

任意/

result_start/"固定"HTTP1.1"固定

必須

文字列

必須

文字列

必須

文字列

63
WPSC003-Ed.1.1 2021-02

No.

4

種

(データ項目)

別

名称

ト
行

文字コード

必須/
説明

任意/

書式

不要
utf-8

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

監視要求を一意に示す ID

必須

文字列

ゲートウェイ ID

必須

文字列

必須

文字列

必須

文字列

データ種別 ID の項目一覧から"監視要5(データ種別 ID)

求(定周期) "を指定する。基本仕様書

X-CPS-dataTypeIdの 4.4.1 項を参照。
(0200000200000000 を指定)

(操作種別 ID)

6

X-CPS-Operation

操作種別 ID の項目一覧から
定周期監視は"GET"を指定する。
基本仕様書の 4.4.2 項を参照。
ID 種別の項目一覧から"ID 種別"、"ア7(依頼元情報)プリケーション ID "を指定する。基本

X-CPS-Source-ID

仕様書の 4.4.3 項を参照。
("03-[アプリケーション ID]"を指定)

ヘ

8

ッ
ダ

(入力形式)
Content-type(タイムスタンプ)

9

X-CPS-Timestamp(監視要求 ID)

10

X-CPS-monitoringRequestId(ゲートウェイ ID)

11

X-CPS-GatewayId

以下のいずれかを指定。
・"application/xml;charset=utf-8"
・"application/json"
ISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(リクエスト時刻)を指定)

正常終了:0

12(実行結果コード)

不正業務アクティビティ有り:1

X-CPS-Result

データプロファイル生成異常:101
その他異常:999

ボ

13

デ
ィ

(リクエスト)request

空文字

64
WPSC003-Ed.1.1 2021-02

② HTTP(S)レスポンス(プッシュ指示の応答(通信結果)のパラメーター
HTTP(S)でデータ応答の通信結果を水道標準プラットフォームから IoT ゲートウェ
イに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す(表 4-19)。
表 4-19: HTTP(S)レスポンスのパラメーター（定周期監視/プッシュ指示の応答）
No.

種(データ項目)

別

名称

必須/
説明

任意/

書式

不要
正常終了:200

1(ステータスコード)

異常(不正要求):400

Status Code

異常(指定したリソースが見つからな

必須

文字列

"0200000200000000"固定

必須

文字列

"GET"固定必須

文字列

03-[アプリケーション ID]を指定

必須

文字列

必須

文字列

必須

文字列

監視要求 ID を指定。

必須

文字列

空文字

必須

文字列

い):404(データ種別 ID)

2

X-CPS-dataTypeId
プ

3

ロ
ト

4

コ
ル
ヘ

5

ッ
ダ

X-CPS-Operation(依頼元情報)X-CPS-Source-ID

リクエスト時のデータが格納(入出力形式)

以下のいずれかを指定。

Content-type

・"application/xml;charset=utf-8"
・"application/json"(タイムスタンプ)

6

X-CPS-Timestamp(監視要求 ID)

7

X-CPS-monitoringRequestId
ボ8(操作種別 ID)

ディ

(レスポンス)
response

ISO8601 に従って応答時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(レスポンス時刻)を指定)

65
WPSC003-Ed.1.1 2021-02

MQTT(プッシュ指示の応答)のパラメーター
水道標準プラットフォームへ応答する場合に使用するプロトコルは、HTTP(S)と MQTT の場合がある。以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル種別：protocol」を参照し、MQTT によるデータ応答のパラメータを記載する。

① MQTT パブリッシュの接続パラメーター
MQTT パブリッシュの接続パラメーターを以下に示す。

表 4-20: MQTT パブリッシュの接続パラメーター
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック

/gw/pf/[監視要求(定周期)]/start/{テナント ID}/{ゲートウェ
イ ID}/{監視要求 ID}

3

文字コード

utf-8

② MQTT パブリッシュ(プッシュ指示の応答) のパラメーター
MQTT パブリッシャーにて、プッシュ指示の応答を IoT ゲートウェイから水道標準プラ
ットフォームに送信する。その際の MQTT パブリッシュのパラメーターを以下に示す。

表 4-21: MQTT パブリッシュのパラメーター（定周期監視/プッシュ指示の応答）

No.

種(データ項目)別名称(インターフェイス包括タグ)

1
プ
2

ロ
ト
コ

3

ル
ボ

CPS-IfElement(ヘッダ包括タグ)
CPS-IfHeader

4

説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID を指定。

(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

X-CPS-dataTypeId

・監視要求(定周期)：

必須

文字列

必須

文字列

"0200000200000000"

デ
ィ

必須/

(操作種別 ID)
X-CPS-Operation

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・"GET"固定66
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
ID 種別、アプリケーション ID が指5(依頼元情報)定される。

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

必須

文字列

必須

文字列

必須

文字列

監視要求 ID を指定

必須

文字列

リクエスト時のゲートウェイ ID

必須

文字列

必須

文字列

("03-[アプリケーション ID]")
IANA に登録された MIME タイプを指
6(入出力形式)定。以下のいずれかが指定。

Content-type

・"application/xml;charset=utf-8"
・"application/json"

ISO8601 に従って要求時刻を指定
7(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指
定)

8

9

(監視要求 ID)
X-CPS-monitoringRequestId(ゲートウェイ ID)
X-CPS-GatewayId

正常終了:0
10(実行結果コード)

不正業務アクティビティ有り:1

X-CPS-Result

データプロファイル生成異常:101
その他異常:999

67
WPSC003-Ed.1.1 2021-02

HTTP(S)(イベントデータ)のパラメーター
水道標準プラットフォームへ応答する場合に使用するプロトコルは、HTTP(S)と MQTT の場合がある。以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル種別：protocol」を参照し、HTTP(S)によるデータ応答のパラメータを記載する。

① HTTP(S)リクエスト(イベントデータ)のパラメーター
HTTP(S)でイベントデータを IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す(表 4-22)。
表 4-22: HTTP(S)リクエストのパラメーター（定周期監視イベントデータ）

No.

種(データ項目)

別

名称

必須/
説明

任意/

書式

不要

1

リ

HTTP メソッド“POST”固定

必須

文字列

2

ク

パス（URL）"/sbi/v1/monitoring/result_data/"固定

必須

文字列

3

エ

プロトコルバージョン"HTTP1.1"固定

必須

文字列

文字コード

utf-8

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

ス

4

ト
行

データ種別 ID の項目一覧から"監視要5(データ種別 ID)

求(定周期) "を指定する。基本仕様書

X-CPS-dataTypeIdの 4.4.1 項を参照。
(0200000200000000 を指定)

(操作種別 ID)

6

X-CPS-Operation
ヘ7

操作種別 ID の項目一覧から
定周期監視は"GET"を指定する。
基本仕様書の 4.4.2 項を参照。
ID 種別の項目一覧から"ID 種別"、"アッ(依頼元情報)プリケーション ID "を指定する。基本

ダ

X-CPS-Source-ID

仕様書の 4.4.3 項を参照。
("03-[アプリケーション ID]"を指定)
以下のいずれかを指定。
【XML 形式の場合】

8(入力形式)

・"application/xml;charset=utf-8"

Content-type【JSON 形式の場合】
・"application/json"

68
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
・データを分割しない場合は指定不要。

(データ分割)9

X-CPS-Data-Split

・データを分割した場合は必須とし、以下を指定する。

必須/
任意

通番 3 桁-総数 3 桁
記載例:002-003
データ分割については、3.4 節参照。

(タイムスタンプ)

10

X-CPS-Timestamp(監視要求 ID)

11

X-CPS-monitoringRequestId(ゲートウェイ ID)

12

X-CPS-GatewayId

ISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ

必須

文字列

監視要求を一意に示す ID

必須

文字列

ゲートウェイ ID

必須

文字列

必須

文字列

詳細は、水道 CPS データプロファイル 必須

文字列(生成日時(リクエスト時刻)を指定)

正常終了:013(実行結果コード)

不正業務アクティビティ有り:1

X-CPS-Result

データプロファイル生成異常:101
その他異常:999

ボ

14

デ
ィ

(業務アクティビティ群)
Activities

定周期監視データのプロパティ

仕様書の 2.4.1 項、2.4.2 項を参照。

69
WPSC003-Ed.1.1 2021-02

② HTTP(S)レスポンス(イベントデータの通信結果)
HTTP(S)でイベントデータの通信結果を水道標準プラットフォームから IoT ゲート
ウェイに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す(表4-23)。
表 4-23: HTTP(S)レスポンスのパラメーター（定周期監視イベントデータ）
No.

種(データ項目)

別

名称

必須/
説明

任意/

書式

不要
正常終了:200(ステータスコード)

1

Status Code

異常(不正要求):400
異常(認識されていない):401

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

任意

文字列

生成日時(レスポンス時刻)を指定

必須

文字列

リクエスト時の監視要求 ID が格納

必須

文字列

空文字

必須

文字列

必須

文字列

異常(指定したリソースが見つからない):404(データ種別 ID)

リクエスト時のデータが格納

X-CPS-dataTypeId"0200000200000000"固定(操作種別 ID)

リクエスト時のデータが格納

X-CPS-Operation“GET”固定ヘ(依頼元情報)リクエスト時のデータが格納

ッ

X-CPS-Source-ID"03-[アプリケーション ID]"を指定

2

3

4

ダ
5

リクエスト時のデータが格納(入出力形式)

以下のいずれかを指定。

Content-type

・"application/xml;charset=utf-8"
・"application/json"

6(データ分割)リクエスト時のデータが格納

X-CPS-Data-Split"[通番 3 桁数字]-[総数 3 桁数字]"(タイムスタンプ)

7

X-CPS-Timestamp(監視要求 ID)

8

X-CPS-monitoringRequestId【正常時の時】(レスポンス)

9ボ

response

デ【異常の時】

ィ(メッセージ)
message

任意のエラーメッセージ。
・アプリベンダー向け標準インターフェイス仕様書 3.5.1「メッセージ仕様」に準拠する。

70
WPSC003-Ed.1.1 2021-02

MQTT パブリシュ（イベントデータ）のパラメーター
定周期監視データを水道標準プラットフォームへ応答する場合に使用するプロトコルは、
HTTP(S)と MQTT の場合がある。
以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル
種別：protocol」を参照し、MQTT によるデータ応答のパラメータを記載する。

① MQTT パブリッシュの接続パラメーター
MQTT パブリッシュの接続パラメーターを以下に示す。
表 4-24: MQTT パブリッシュの接続パラメーター
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック

/gw/pf/[監視要求 (定周期)]/{テナント ID}/{ゲートウェイ
ID}/{監視要求 ID}

3

文字コード

utf-8

② MQTT パブリッシュ(イベントデータ) のパラメーター
MQTT パブリッシャーにて、イベントデータの内容を IoT ゲートウェイから水道標準プ
ラットフォームに送信する。その際の MQTT パブリッシュのパラメーターを以下に示す。
表 4-25: MQTT パブリッシュのパラメーター（定周期監視イベントデータ）
No.

種(データ項目)別名称(インターフェイス包括タグ)

1
プ
2

ロ
ト
コ

3

ル
ボ

CPS-IfElement(ヘッダ包括タグ)
CPS-IfHeader

4

説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID を指定。

(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

X-CPS-dataTypeId

・監視要求(定周期)：

必須

文字列

必須

文字列

"0200000200000000"

デ
ィ

必須/

(操作種別 ID)
X-CPS-Operation

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・定周期監視要求："GET"71
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
ID 種別、アプリケーション ID が指5(依頼元情報)定される。

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

必須

文字列

必須

文字列

("03-[アプリケーション ID]")
IANA に登録された MIME タイプを指定。以下のいずれかが指定。
6(入出力形式)【XML 形式の場合】

Content-type

・"application/xml;charset=utf-8"【JSON 形式の場合】
・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。

必須/

通番 3 桁-総数 3 桁

任意

記載例:002-003

文字列

データ分割については、3.4 節参照。
ISO8601 に従って要求時刻を指定
8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

監視要求を一意に示す ID

必須

文字列

リクエスト時のゲートウェイ ID

必須

文字列

必須

文字列

必須

文字列

定)
9

10

(監視要求 ID)
X-CPS-monitoringRequestId(ゲートウェイ ID)
X-CPS-GatewayId

正常終了:0
11(実行結果コード)

不正業務アクティビティ有り:1

X-CPS-Result

データプロファイル生成異常:101
その他異常:999

12

CPS-IfBody

ボディ包括タグ
定周期監視データのデータプロフ

13(業務アクティビティ群)
Activitiesァイル
詳細は、水道 CPS データプロファイ
ル仕様書の 2.4.1 項、2.4.2 項を参照。
72
WPSC003-Ed.1.1 2021-02定周期監視停止インターフェイスにおける詳細フローとパラメーター
定周期監視停止のプッシュ指示の要求、プッシュ指示の応答における MQTT/HTTP(S)の詳
細フロー及びパラメーターを示す。
詳細フロー
定周期監視停止のプッシュ指示の要求とプッシュ指示の応答の詳細フローを以下に示す(図 4-4)。

広域向け
アプリケーション

水道標準
プラットフォーム

操作種別 ID で”DELETE”を指定

IoT
ゲートウェイデバイス

プッシュ指示の要求
MQTT サブスクライバー(プッシュ指示の要求)

停止要求受信後
イベントデータ送信
は停止

HTTP(S)の場合
デ
ー
タ
要
求

デ
ー
タ

プッシュ指示の応答
HTTP(S)リクエスト(プッシュ指示の応答)

HTTP(S)レスポンス(プッシュ指示の応答の通信結果)

要求

MQTT の場合

復号

プッシュ指示の応答
MQTT パブリッシュ(プッシュ指示の応答)【凡例】

送信するデータ毎にトピックを指定：標準化対象インターフェイス

図 4-4: 定周期監視の停止要求詳細フロー

要求データ取得のパラメーター
MQTT サブスクライバーにより、要求データを取得する。
4.3 要求データ取得共通インターフェイスを参照。

73
WPSC003-Ed.1.1 2021-02

HTTP(S)(プッシュ指示の応答（停止）)のパラメーター
水道標準プラットフォームへ応答する場合に使用するプロトコルは、HTTP(S)と MQTT の場合がある。以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル種別：protocol」を参照し、HTTP(S)によるデータ応答のパラメータを記載する。

① HTTP(S)リクエスト(プッシュ指示の応答(停止結果)のパラメーター
HTTP(S)でプッシュ指示（停止）の応答を IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す(表 4-26)。
表 4-26: HTTP(S)リクエストのパラメーター（定周期監視(停止)）

No.
1
2
3
4

種

(データ項目)

別

名称

リ
ク
エ
ス
ト
行

HTTP メソッド
パス（URL）

必須/
説明

任意/

書式

不要
“POST”固定"/sbi/v1/monitoring/result_stop/"
固定

必須

文字列

必須

文字列

プロトコルバージョン"HTTP1.1"固定

必須

文字列

文字コード

utf-8

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

データ種別 ID の項目一覧から"監視要5(データ種別 ID)

求(定周期)"を指定する。基本仕様書

X-CPS-dataTypeIdの 4.4.1 項を参照。
(0200000200000000 を指定)
操作種別 ID の項目一覧から"DELETE"

6(操作種別 ID)を指定する。基本仕様書の 4.4.2 項を

X-CPS-Operation

参照。
(“DETELE”を指定)

ヘ
ッ

7

ダ

ID 種別、アプリケーション ID が指定(依頼元情報)される。

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。
("03-[アプリケーション ID]")

8

9(入力形式)
Content-type(タイムスタンプ)
X-CPS-Timestamp

以下のいずれかを指定。
・"application/xml;charset=utf-8"
・"application/json"
ISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(リクエスト時刻)を指定)

74
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)別名称(監視要求 ID)

10

X-CPS-monitoringRequestId(ゲートウェイ ID)

11

X-CPS-GatewayId

12
ボ

13

デ
ィ

必須/
説明

監視要求 ID を指定。

必須

文字列

ゲートウェイ ID

必須

文字列

必須

文字列

必須

文字列

正常終了:0X-CPS-Result

その他異常:999

request

書式

不要(実行結果コード)(リクエスト)任意/

空文字② HTTP(S)レスポンス(プッシュ指示の応答(停止結果)のパラメーター
HTTP(S)でデータ応答の通信結果を水道標準プラットフォームから IoT ゲートウェ
イに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す(表 4-27)。
表 4-27: HTTP(S)レスポンスのパラメーター（定周期監視(停止)）No

種(データ項目)

.

別

名称

必須/
説明

任意/

書式

不要
正常終了:200

1(ステータスコード)

異常(不正要求):400

Status Code

異常(指定したリソースが見つからな

必須

文字列

"0200000200000000"固定

必須

文字列

"DETELE"固定

必須

文字列

03-[アプリケーション ID]を固定

必須

文字列

必須

文字列

必須

文字列

い):404(データ種別 ID)

2

3

4

X-CPS-dataTypeId(操作種別 ID)ヘ

X-CPS-Operation

ッ(依頼元情報)ダ

X-CPS-Source-ID

リクエスト時のデータが格納
5(入出力形式)

以下のいずれかを指定。

Content-type

・"application/xml;charset=utf-8"
・"application/json"

6(タイムスタンプ)
X-CPS-Timestamp

ISO8601 に従って応答時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(レスポンス時刻)を指定)
75
WPSC003-Ed.1.1 2021-02

No

種(データ項目)

.

別

名称

7
ボ
8

デ
ィ

必須/
説明

任意/
不要

(監視要求 ID)

リクエストで指定した監視要求 ID が

X-CPS-monitoringRequestId

格納(レスポンス)
response

書式

空文字

必須

文字列

必須

文字列

76
WPSC003-Ed.1.1 2021-02

MQTT(プッシュ指示の応答（停止）)のパラメーター
水道標準プラットフォームへ応答する場合に使用するプロトコルは、HTTP(S)と MQTT の場合がある。以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル種別：protocol」を参照し、MQTT によるデータ応答のパラメータを記載する。

① MQTT パブリッシュの接続パラメーター
MQTT パブリッシュの接続パラメーターを以下に示す。

表 4-28: MQTT パブリッシュの接続パラメーター
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック

/gw/pf/[監視要求(定周期)]/stop/{テナント ID}/{ゲートウェ
イ ID}/{監視要求 ID}

3

文字コード

utf-8

② MQTT パブリッシュ(データ応答) のパラメーター
MQTT パブリッシャーにて、データ応答の内容を IoT ゲートウェイから水道標準プラッ
トフォームに送信する。その際の MQTT パブリッシュのパラメーターを以下に示す。

表 4-29: MQTT パブリッシュのパラメーター（定周期監視(停止)）No.

種(データ項目)別名称(インターフェイス包括タグ)

1
プ
2

ロ
ト
コ

3

ル
ボ

CPS-IfElement(ヘッダ包括タグ)
CPS-IfHeader

4

説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID を指定。

(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

X-CPS-dataTypeId

・監視要求(定周期)：

必須

文字列

必須

文字列

"0200000200000000"

デ
ィ

必須/

(操作種別 ID)
X-CPS-Operation

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・"DELETE"固定77
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
ID 種別、アプリケーション ID が指5(依頼元情報)定される。

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

必須

文字列

必須

文字列

必須

文字列

監視要求 ID を指定

必須

文字列

リクエスト時のゲートウェイ ID

必須

文字列

必須

文字列

("03-[アプリケーション ID]")
IANA に登録された MIME タイプを指
6(入出力形式)定。以下のいずれかが指定。

Content-type

・"application/xml;charset=utf-8"
・"application/json"

ISO8601 に従って要求時刻を指定
7(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指
定)

8

9

10

(監視要求 ID)
X-CPS-monitoringRequestId(ゲートウェイ ID)
X-CPS-GatewayId(実行結果コード)

正常終了:0X-CPS-Result

その他異常:999

78
WPSC003-Ed.1.1 2021-02

4.6 制御値設定インターフェイス
制御値設定インターフェイスは、データ操作(変更)プル型を使用する。詳細は、図 3-13 を参照。
データ応答のレスポンスに使用するプロトコルは、MQTT/HTTP(S)を利用する。
制御値設定における詳細フローとパラメーター
制御値設定の要求データの取得、制御値設定の各データ応答における MQTT/HTTP(S)の詳
細フロー及びパラメーターを以下に示す。
詳細フロー
制御値設定の詳細フローは、前述(3.5.3 項の(3))を参照。
要求データ取得のパラメーター
MQTT サブスクライバーにより、要求データを取得する。
4.3 要求データ取得共通インターフェイスを参照。
HTTP(S)(制御要求受付の応答)のパラメーター
制御値設定の要求データの受付を水道標準プラットフォームへ応答する場合に使用するプロトコルは、HTTP(S)と MQTT の場合がある。
以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル
種別：protocol」を参照し、HTTP(S)によるデータ応答のパラメータを記載する。

① HTTP(S)リクエスト(制御要求受付の応答) のパラメーター
HTTP(S)で制御要求受付の応答を IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す(表 4-30)。
表 4-30: HTTP(S)リクエストのパラメーター（制御値設定/制御要求受付の応答）

No.
1
2
3
4

種

(データ項目)

別

名称

リ
ク
エ
ス
ト
行

HTTP メソッド
パス（URL）

必須/
説明

任意/

書式

不要
“POST”固定"/sbi/v1/device_control/
sending_result/"固定

必須

文字列

必須

文字列

プロトコルバージョン"HTTP1.1"固定

必須

文字列

文字コード

utf-8

必須

文字列

79
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
データ種別 ID の項目一覧から"制御値5(データ種別 ID)

設定"を指定する。基本仕様書の 4.4.1

X-CPS-dataTypeId

項を参照。

必須

文字列

必須

文字列

必須

文字列

必須

文字列

(0200000600000000 を指定)
(操作種別 ID)

6

X-CPS-Operation

操作種別 ID の項目一覧から
定周期監視は"PUT"を指定する。
基本仕様書の 4.4.2 項を参照。
ID 種別の項目一覧から"ID 種別"、"ア7(依頼元情報)プリケーション ID "を指定する。基本

X-CPS-Source-ID

仕様書の 4.4.3 項を参照。
("03-[アプリケーション ID]"を指定)(入力形式)

8

Content-type

以下のいずれかを指定。
・"application/xml;charset=utf-8"
・"application/json"
・1 回目の要求時には指定不要。

ヘ9・データを分割した場合は必須とし、ッ(データ分割)以下を指定する。

必須/ダ

X-CPS-Data-Split

通番 3 桁-総数 3 桁

任意

文字列

記載例:002-003
データ分割については、3.4 節参照。

10

11

(タイムスタンプ)
X-CPS-Timestamp(制御要求 ID)
X-CPS-controlRequestId

ISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ

必須

文字列

必須

文字列

必須

文字列

必須

文字列

(生成日時(リクエスト時刻)を指定)
制御要求を一意に示す ID
正常終了（制御要求送信）:0
正常終了（制御要求結果）:1

12(実行結果コード)

正常終了（制御操作結果）:2

X-CPS-Result

不正業務アクティビティ有り:100
データプロファイル生成異常:101
その他異常:999

13(ゲートウェイ ID)
X-CPS-GatewayId

ゲートウェイ ID

80
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

ボ

14

デ
ィ

(制御要求送信結果)
result

必須/
説明

任意/

書式

不要
以下のいずれかを指定
・{"result":"OK"}

必須

文字列

・{"result":"NG"}81
WPSC003-Ed.1.1 2021-02

② HTTP(S)レスポンス(制御要求受付の応答)のパラメーター
HTTP(S)で制御要求受付の応答の通信結果を水道標準プラットフォームから IoT ゲ
ートウェイに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す(表4-31)。
表 4-31: HTTP(S)レスポンスのパラメーター（定周期監視/プッシュ指示の応答）
No.

種(データ項目)

別

名称

必須/
説明

任意/

書式

不要
正常終了:200(ステータスコード)

1

Status Code

異常(不正要求):400
異常(認識されていない):401

必須

文字列

"0200000600000000"固定

必須

文字列

"PUT"固定必須

文字列

03-[アプリケーション ID]を指定

必須

文字列

必須

文字列

必須

文字列

制御要求 ID を指定。

必須

文字列

空文字

必須

文字列

異常(指定したリソースが見つからない):404(データ種別 ID)

2

3

4

プ

X-CPS-dataTypeId

ロ(操作種別 ID)ト

X-CPS-Operation

コ(依頼元情報)ル

X-CPS-Source-ID

ヘ5

リクエスト時のデータが格納

ッ(入出力形式)

以下のいずれかを指定。

ダ

Content-type

・"application/xml;charset=utf-8"
・"application/json"(タイムスタンプ)

6

X-CPS-Timestamp(制御要求 ID)

7

X-CPS-controlRequestId
ボ

8

デ
ィ

(レスポンス)
response

ISO8601 に従って応答時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(レスポンス時刻)を指定)

82
WPSC003-Ed.1.1 2021-02

HTTP(S)(制御結果の応答)のパラメーター
IoT ゲートウェイがデバイスに対して、制御要求を開始した後の制御完了データを、制御
結果の応答として、水道標準プラットフォームへ応答する場合に使用するプロトコルは、
HTTP(S)と MQTT の場合がある。
以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル
種別：protocol」を参照し、HTTP(S)によるデータ応答のパラメータを記載する。

① HTTP(S)リクエスト(制御結果の応答) のパラメーター
HTTP(S)で制御結果の応答を IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す(表 4-32)。
表 4-32: HTTP(S)リクエストのパラメーター（制御値設定/制御結果の応答）

No.
1
2
3
4

種

(データ項目)

別

名称

リ
ク
エ
ス
ト
行

HTTP メソッド
パス（URL）

必須/
説明

任意/

書式

不要
“POST”固定"/sbi/v1/device_control/
manipulation_result/"固定

必須

文字列

必須

文字列

プロトコルバージョン"HTTP1.1"固定

必須

文字列

文字コード

utf-8

必須

文字列

必須

文字列

必須

文字列

必須

文字列

データ種別 ID の項目一覧から"制御値5(データ種別 ID)

設定"を指定する。基本仕様書の 4.4.1

X-CPS-dataTypeId

項を参照。
(0200000600000000 を指定)

ヘ

6

ッ
ダ

(操作種別 ID)
X-CPS-Operation

操作種別 ID の項目一覧から
定周期監視は"PUT"を指定する。
基本仕様書の 4.4.2 項を参照。
ID 種別の項目一覧から"ID 種別"、"ア7(依頼元情報)プリケーション ID "を指定する。基本

X-CPS-Source-ID

仕様書の 4.4.3 項を参照。
("03-[アプリケーション ID]"を指定)

83
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
IANA に登録された MIME タイプを指定。
以下のいずれかを指定。

(入力形式)

8

Content-type【XML 形式の場合】
・"application/xml;charset=utf-8"

必須

文字列

【JSON 形式の場合】
・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須とし、

9(データ分割)以下を指定する。

必須/

X-CPS-Data-Split

通番 3 桁-総数 3 桁

任意

文字列

記載例:002-003
データ分割については、3.4 節参照。
(タイムスタンプ)

10

X-CPS-Timestamp(制御要求 ID)

11

X-CPS-controlRequestId

ISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

(生成日時(リクエスト時刻)を指定)
制御要求を一意に示す ID
正常終了（制御要求送信）:0
正常終了（制御要求結果）:1

12(実行結果コード)

正常終了（制御操作結果）:2

X-CPS-Result

不正業務アクティビティ有り:100
データプロファイル生成異常:101
その他異常:999(ゲートウェイ ID)

13

X-CPS-GatewayId
ボ

14

デ
ィ

ゲートウェイ ID
制御値設定完了のデータプロファイ(業務アクティビティ群)

ル

Activities

詳細は、水道 CPS データプロファイル
仕様書の 2.4.1 項、2.4.2 項を参照。

② HTTP(S)レスポンス(制御結果の応答)のパラメーター
HTTP(S)で制御結果の応答の通信結果を水道標準プラットフォームから IoT ゲート
ウェイに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す(表4-33)。
84
WPSC003-Ed.1.1 2021-02

表 4-33: HTTP(S)レスポンスのパラメーター（定周期監視/制御結果の応答）
No.

種(データ項目)

別

名称

必須/
説明

任意/

書式

不要
正常終了:200(ステータスコード)

1

Status Code

異常(不正要求):400
異常(認識されていない):401

必須

文字列

"0200000600000000"固定

必須

文字列

"PUT"固定必須

文字列

03-[アプリケーション ID]を指定

必須

文字列

必須

文字列

必須

文字列

必須

文字列

異常(指定したリソースが見つからない):404(データ種別 ID)

2

3

4

5

X-CPS-dataTypeId
プ(操作種別 ID)ロ

X-CPS-Operation

ト(依頼元情報)コ

X-CPS-Source-IDル

以下のいずれかを指定。

ヘ【XML 形式の場合】

ッ(入出力形式)・"application/xml;charset=utf-8"

ダ

Content-type【JSON 形式の場合】
・"application/json"

6

7(タイムスタンプ)
X-CPS-Timestamp(制御要求 ID)
X-CPS-controlRequestId

ISO8601 に従って応答時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(レスポンス時刻)を指定)
制御要求 ID を指定。

85
WPSC003-Ed.1.1 2021-02

MQTT(制御要求受付の応答)のパラメーター
制御値設定の要求データの受付を水道標準プラットフォームへ応答する場合に使用するプロトコルは、HTTP(S)と MQTT の場合がある。
以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル
種別：protocol」を参照し、MQTT によるデータ応答のパラメータを記載する。

① MQTT パブリッシュの接続パラメーター
MQTT パブリッシュの接続パラメーターを以下に示す。

表 4-34: MQTT パブリッシュの接続パラメーター
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック"/gw/pf/[制御値設定]/sending_result/事業体 ID/ゲートウェ
イ ID"

3

文字コード

utf-8

(ア)MQTT パブリッシュ(制御要求受付の応答) のパラメーター
MQTT パブリッシャーにて、制御要求受付の応答を IoT ゲートウェイから水道標準プラ
ットフォームに送信する。その際の MQTT パブリッシュのパラメーターを以下に示す。

表 4-35: MQTT パブリッシュのパラメーター（制御値設定/制御要求受付の応答）

No.

種(データ項目)別名称(インターフェイス包括タグ)

1

CPS-IfElement(ヘッダ包括タグ)

2

CPS-IfHeader
ボ

3

必須/
説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID を指定。

デ

(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

ィ

X-CPS-dataTypeId

・制御値設定：

必須

文字列

必須

文字列

"0200000600000000"

4(操作種別 ID)
X-CPS-Operation

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・"PUT"固定86
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
ID 種別、アプリケーション ID が指5(依頼元情報)定される。

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

必須

文字列

必須

文字列

("03-[アプリケーション ID]")
IANA に登録された MIME タイプを指
6(入出力形式)定。以下のいずれかが指定。

Content-type

・"application/xml;charset=utf-8"
・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。

必須/

通番 3 桁-総数 3 桁

任意

記載例:002-003

文字列

データ分割については、3.4 節参照。
ISO8601 に従って要求時刻を指定
8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

定)
9

(制御要求 ID)
X-CPS-controlRequestId

制御要求 ID を指定
正常終了（制御要求送信）:0
正常終了（制御要求結果）:1

10(実行結果コード)

正常終了（制御操作結果）:2

X-CPS-Result

不正業務アクティビティ有り:100
データプロファイル生成異常:101
その他異常:999

11
12

13

(ゲートウェイ ID)
X-CPS-GatewayId
CPS-IfBody(制御要求送信結果)
resultリクエスト時のゲートウェイ ID
ボディ包括タグ
以下のいずれかを指定
・{"result":"OK"}・{"result":"NG"}87
WPSC003-Ed.1.1 2021-02

MQTT(制御結果の応答)のパラメーター
IoT ゲートウェイがデバイスに対して、制御要求を開始した後の制御完了データを、制御
結果の応答として、水道標準プラットフォームへ応答する場合に使用するプロトコルは、
HTTP(S)と MQTT の場合がある。
以下は、ゲートウェイ接続インターフェイスのレスポンスのパラメータの「プロトコル
種別：protocol」を参照し、MQTT によるデータ応答のパラメータを記載する。

① MQTT パブリッシュの接続パラメーター
MQTT パブリッシュの接続パラメーターを以下に示す。

表 4-36: MQTT パブリッシュの接続パラメーター
No.

項目

内容

1

ブローカー

ssl://{水道標準プラットフォームのホスト名}：ポート番号2

データ要求 トピック

/gw/pf/[制御値設定]/manipulation_result/{テナント ID}/{ゲートウェイ ID}

3

文字コード

utf-8

② MQTT パブリッシュ(制御結果の応答) のパラメーター
MQTT パブリッシャーにて、制御結果の応答を IoT ゲートウェイから水道標準プラット
フォームに送信する。その際の MQTT パブリッシュのパラメーターを以下に示す。

表 4-37: MQTT パブリッシュのパラメーター（制御値設定/制御結果の応答）

No.

種(データ項目)別名称(インターフェイス包括タグ)

1

CPS-IfElement(ヘッダ包括タグ)

2

CPS-IfHeader
ボ

3

必須/
説明

任意/

書式

不要
インターフェイス包括タグ

ヘッダ包括タグ
データ種別 ID を指定。

デ

(データ種別 ID)

基本仕様書の 4.4.1 項を参照。

ィ

X-CPS-dataTypeId

・制御値設定：

必須

文字列

必須

文字列

"0200000600000000"

4(操作種別 ID)
X-CPS-Operation

操作種別 ID が指定される。
基本仕様書の 4.4.2 項を参照。
・"PUT"固定88
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
ID 種別、アプリケーション ID が指5(依頼元情報)定される。

X-CPS-Source-ID

基本仕様書の 4.4.3 項を参照。

必須

文字列

必須

文字列

("03-[アプリケーション ID]")
IANA に登録された MIME タイプを指定。以下のいずれかを指定。
6(入出力形式)【XML 形式の場合】

Content-type

・"application/xml;charset=utf-8"【JSON 形式の場合】
・"application/json"

・1 回目の要求時には指定不要。
・データを分割した場合は必須と

7(データ分割)X-CPS-Data-Split

し、以下を指定する。

必須/

通番 3 桁-総数 3 桁

任意

記載例:002-003

文字列

データ分割については、3.4 節参照。
ISO8601 に従って要求時刻を指定
8(タイムスタンプ)

YYYY-MM-DDThh:mm:ss.SSSZX-CPS-Timestamp(生成日時(リクエスト時刻)を指

必須

文字列

制御要求 ID を指定

必須

文字列

リクエスト時のゲートウェイ ID

必須

文字列

必須

文字列

定)
9

10

(制御要求 ID)
X-CPS-controlRequestId(ゲートウェイ ID)
X-CPS-GatewayId

正常終了（制御要求送信）:0
正常終了（制御要求結果）:1
11(実行結果コード)

正常終了（制御操作結果）:2

X-CPS-Result

不正業務アクティビティ有り:100
データプロファイル生成異常:101
その他異常:999

12

CPS-IfBody

ボディ包括タグ

89
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要
制御値設定完了のデータプロファ

13(業務アクティビティ群)
Activities

イル
詳細は、水道 CPS データプロファイ 必須

文字列

ル仕様書の 2.4.1 項、2.4.2 項を参照。

90
WPSC003-Ed.1.1 2021-02

4.7 公開鍵証明書ファイル取得インターフェイス
公開鍵証明書ファイル取得インターフェイスは、水道標準プラットフォーム証明書、又はア
プリケーション証明書ファイルの取得を行う。
公開鍵証明書ファイル取得インターフェイスでは HTTP(S)プロトコルを利用する。
公開鍵証明書ファイル取得における詳細フローとパラメーター
HTTP(S)の詳細フロー及びパラメーターを示す。
詳細フロー
公開鍵証明書ファイル取得の詳細フローを以下に示す(図 4-5)。

広域向け
アプリケーション

水道標準
プラットフォーム

取
得
要
求
の
応
答

IoT
ゲートウェイ

HTTP(S)リクエスト(公開鍵証明書ファイル取得要求)
HTTP(S)レスポンス(公開鍵証明書ファイルの応答)

機器ベンダー向け
標準インターフェイス(デバイス)

取
得
要
求
の
送
信

【凡例】
：標準化対象インターフェイス

図 4-5: 公開鍵証明書ファイル取得の詳細フローリクエスト(要求情報)のパラメーター
HTTP(S)でデータ保護用公開鍵証明書ファイル取得情報を IoT ゲートウェイから水道
標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す。
表 4-38 HTTP(S)リクエストのパラメーター（公開鍵証明書ファイル取得）
No.
1

種

(データ項目)別名称

リ

HTTP メソッド

必須/
説明

任意/

書式

不要
“POST”固定

必須

文字列

91
WPSC003-Ed.1.1 2021-02

No.

2
3
4

種

(データ項目)

別

名称

ク
エ
ス
ト
行

パス（URL）

必須/
説明

任意/

書式

不要
"/cps-platform/sbi/v1/certificate/"

固定

必須

文字列

プロトコルバージョン"HTTP1.1"固定

必須

文字列

文字コード

utf-8

必須

文字列

必須

文字列

定する。
基本仕様書の 4.4.2 項を参照。 必須

文字列

データ種別 ID の項目一覧から"データ5(データ種別 ID)

保護公開鍵証明書ファイル "を指定

X-CPS-dataTypeId

する。基本仕様書の 4.4.1 項を参照。
(0200000500000000 を指定)

(操作種別 ID)

6

X-CPS-Operation

操作種別 ID の項目一覧から"GET"を指(“GET”を指定)
ID 種別の項目一覧から"ID 種別"、"ゲ7(依頼元情報)ートウェイ ID "を指定する。基本仕様

X-CPS-Source-ID

書の 4.4.3 項を参照。

8

ダ

文字列

必須

文字列

任意

文字列

必須

文字列

不要

文字列

(“04-[ゲートウェイ ID]”を指定)

ヘ
ッ

必須

(入力形式)
Content-type

以下のいずれかを指定。
・"application/xml;charset=utf-8"
・"application/json"
取得対象の公開鍵証明書のバージョ9(公開鍵バージョン ID)

ン番号を設定。設定されていない場

X-CPS-PublicKeyVersionId

合、最新バージョン番号の公開鍵証明書を取得(タイムスタンプ)

10

X-CPS-Timestamp(要求 ID)

11
12

X-CPS-monitoringRequestId
ボ(リクエスト)デrequestISO8601 に従って要求時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(リクエスト時刻)を指定)(なし)

ボディ包括タグ

92
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)

別

名称

ィ

必須/
説明

任意/

書式

不要
データ保護用公開鍵証明書の取得条
件を指定。

13

(取得条件)
certificateRequestId

・水道標準プラットフォームの場
合：

必須

文字列

"0000"を指定
・ゲートウェイの場合"[ゲートウェイ ID]"を指定

93
WPSC003-Ed.1.1 2021-02

レスポンス(応答情報)のパラメーター
HTTP(S)でデータ保護用公開鍵証明書ファイル取得の通信結果を水道標準プラットフ
ォームから IoT ゲートウェイに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す。
表 4-39 HTTP(S)レスポンスのパラメーター（公開鍵証明書ファイル取得）
No.

種(データ項目)

別

名称

レ

ポ

(ステータスコード)

ン

Status Codeス

(データ種別 ID)
X-CPS-dataTypeId(操作種別 ID)

3

X-CPS-Operation(依頼元情報)

4

任意/

書式

不要

異常(不正要求):400
異常(認識されていない):401

必須

文字列

"0200000500000000"固定

必須

文字列

"GET"固定必須

文字列

04-[ゲートウェイ ID]を指定

必須

文字列

必須

文字列

必須

文字列

必須

文字列

必須

文字列

"NULL"固定不要

文字列

データ保護公開鍵証明書バイナリ

必須

異常(指定したリソースが見つからない):404)

行

2

説明

正常終了:200

ス

1

必須/

X-CPS-Source-ID

【正常時】

5

(出力形式)
ヘ

Content-type

ッ
ダ

6
7

10

取得した公開鍵証明書のバージョン

X-CPS-PublicKeyVersionId

番号を設定(有効期限)

取得した公開鍵証明書の有効期限を

X-CPS-ExpirationDate

設定(要求 ID)
X-CPS-monitoringRequestId
ボ

リクエスト時の「入力形式」で指定(公開鍵バージョン ID)

X-CPS-Timestamp

9

【異常時】

した内容

(タイムスタンプ)

8・application/octet-stream を指定

ISO8601 に従って応答時刻を指定
YYYY-MM-DDThh:mm:ss.SSSZ(生成日時(レスポンス時刻)を指定)【正常の時】

デ(証明書情報)ィCertificate Information

バイナ
リ

94
WPSC003-Ed.1.1 2021-02

No.

種

(データ項目)別名称【異常の時】(メッセージ)
message

必須/
説明

任意/

書式

不要
任意のエラーメッセージ。
・アプリベンダー向け標準インターフェイス仕様書 3.5.1「メッセージ

必須

文字列

仕様」に準拠する。

95
WPSC003-Ed.1.1 2021-02

4.8 ファイル登録操作インターフェイス
ファイル登録操作インターフェイスはオブジェクトストレージにファイルを登録する。ファイル登録操作では HTTP(S)プロトコルを利用する。
ファイル登録操作における詳細フローとパラメータ
HTTP(S)の詳細フロー及びパラメータを示す。
詳細フロー
ファイル登録操作の詳細フローを以下に示す(図 4-6)。

広域向け
アプリケーション

水道標準
プラットフォーム

IoT
ゲートウェイ

デバイス

ファイルデータの取得

ファイル登録操作

フ
ァ
イ
ル
登
録
操
作

HTTP(S)リクエスト(ファイル登録操作)
HTTP(S)レスポンス(ファイル登録操作の通信結果)

ファイル登録情報の送信

ファイル登録操作結果
機器ベンダー向け
標準インターフェイス(デバイス)【凡例】：標準化対象インターフェイス

図 4-6: ファイル登録操作の詳細フローリクエスト(要求情報)のパラメーター
HTTP(S)で要求情報を IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す（表 4-40）。
表 4-40: HTTP(S)リクエストのパラメーター（ファイル登録操作）
No

1

種

(データ項目)別名称

リ HTTP メソッド

必須/
説明

任意/

書式

不要
“PUT”固定

必須

文字列

96
WPSC003-Ed.1.1 2021-02

No

2

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要

ク

/sbi/v1/dev/files/{リソース ID}/{オブジェエクト ID}

ス{リソース ID}はドキュメントの格納先を一意

ト パス（URL）に示す ID行{オブジェクト ID}はドキュメントを一意に示

必須

文字列

す ID。「フォルダ+ファイル名」を「/」区切りで設定。末尾に「/」は設定不可
3プロトコルバージョン"HTTP1.1"固定

必須

文字列

4

文字コード

utf-8

必須

文字列

必須

文字列

必須

文字列

(入力形式)

5

Content-Type(出力形式)

6

Accept
ボ

7

デ
ィ

(データ)
data

入力時の入出力形式
IANA に登録された以下の MIME タイプを指定
・"application/octet-stream"
出力時の入出力形式
IANA に登録された以下の MIME タイプを指定
・"application/json"

保存するファイルのバイナリデータ

任意

バ イ ナ
リ

97
WPSC003-Ed.1.1 2021-02

レスポンス(応答情報) のパラメーター
HTTP(S)でファイル登録の通信結果を水道標準プラットフォームから IoT ゲートウェイに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す（表 4-41）。
表 4-41: HTTP(S)レスポンスのパラメーター（ファイル登録操作）
No

1

種

(データ項目)

別

名称

必須/
説明

任意/

書式

不要

レ

HTTP ステータスコード(RFC2616、ス

RFC7231)に従った、要求に対する実行結

ポ

果コード

ン (実行結果コード)

・処理成功：200 固定

ス Status Code・不正要求：400 固定

行

・AP 未接続：404 固定

必須

文字列

"application/json"

必須

文字列

空文字

必須

文字列

・処理失敗：404 固定（指定したリソースが見つからない）
ヘ
2

ッ
ダ
ボ

3

デ
ィ

(出力形式)
Content-Type(レスポンス)
response

98
WPSC003-Ed.1.1 2021-02

4.9 ファイル削除操作インターフェイス
ファイル削除操作インターフェイスはオブジェクトストレージからファイルを削除する。ファイル削除操作では HTTP(S)プロトコルを利用する。
ファイル削除操作における詳細フローとパラメーター
HTTP(S)の詳細フロー及びパラメータを示す。
詳細フロー
ファイル削除操作の詳細フローを以下に示す(図 4-7)。

広域向け
アプリケーション

水道標準
プラットフォーム

IoT
ゲートウェイ

デバイス

ファイルデータの取得

フ
ァ
イ
ル
削
除
操
作

ファイル削除操作
HTTP(S)リクエスト(ファイル削除操作)
HTTP(S)レスポンス(ファイル削除操作の通信結果)

ファイル削除情報の送信

ファイル削除操作結果
機器ベンダー向け
標準インターフェイス(デバイス)【凡例】：標準化対象インターフェイス

図 4-7: ファイル削除操作の詳細フロー99
WPSC003-Ed.1.1 2021-02

リクエスト(要求情報)のパラメーター
HTTP(S)でファイル削除情報を IoT ゲートウェイから水道標準プラットフォームに送信する。その際の HTTP(S)リクエストのパラメーターを以下に示す（表 4-42）。
表 4-42: HTTP(S)リクエストのパラメーター（ファイル削除操作）No

種(データ項目)別名称

1

HTTP メソッド

必須/
説明

任意/

書式

不要
“DELETE”固定

必須

文字列

必須

文字列

/sbi/v1/dev/files/{リソース ID}/{オブジェクト ID}

リ{リソース ID}はドキュメントの格納先を一意

ク
2エ パス（URL）
スに示す ID{オブジェクト ID}はドキュメントを一意に示す ID。「フォルダ+ファイル名」を「/」区切

トりで設定。末尾にスラッシュがある場合、エ

行

ラーとする

3

プロトコルバージョン"HTTP1.1"固定

必須

文字列

4

文字コード

utf-8

必須

文字列

必須

文字列

ヘ
5

ッ
ダ

(出力形式)
Accept

出力時の入出力形式
IANA に登録された以下の MIME タイプを指定
・"application/json"

100
WPSC003-Ed.1.1 2021-02

レスポンス(応答情報) のパラメーター
HTTP(S)でファイル削除の通信結果を水道標準プラットフォームから IoT ゲートウェイに返却する。その際の HTTP(S)レスポンスのパラメーターを以下に示す（表 4-43）。
表 4-43: HTTP(S)レスポンスのパラメーター（ファイル削除操作）No

種(データ項目)

別

名称

説明

任意/

HTTP ステータスコード(RFC2616、ス

RFC7231)に従った、要求に対する実行結

ポ

果コード

ス
行

(実行結果コード)
Status Code

書式

不要

レ

ン
1

必須/

・処理成功：200 固定
・不正要求：400 固定

必須

文字列

"application/json"

必須

文字列

空文字

必須

文字列

・AP 未接続：404 固定
・処理失敗：404 固定（指定したリソースが見つからない）（対象のファイルが存在しない）

ヘ
2

ッ
ダ
ボ

3

デ
ィ

(出力形式)
Content-Type(レスポンス)
response

101
WPSC003-Ed.1.1 2021-02

5. データプロパティ仕様
各データ種別のプロパティ仕様を以下に記載する。

5.1 即時/定周期監視/制御値設定データのプロパティ仕様
即時監視データのプロパティ仕様は、水道 CPS データプロファイル仕様書の 2.4.1 項、2.4.2項を参照。
定周期監視データのプロパティ仕様は、水道 CPS データプロファイル仕様書の 2.4.1 項を参照。
制御値設定データのプロパティ仕様は、水道 CPS データプロファイル仕様書の 2.4.1 項を参照。

102
WPSC003-Ed.1.1 2021-02

5.2 ゲートウェイ接続情報のプロパティ仕様
ゲートウェイ接続情報のプロパティ仕様を以下に示す(表 5-1)。
表 5-1: ゲートウェイ接続情報のプロパティ仕様
No.

XML

1

accessInformation

名称

型

内容

2

gwId

ゲートウェイ ID

Stringゲートウェイ ID

3

gwNameゲートウェイ 名Stringゲートウェイ名

例"02012345
6789""IoTGW-1"

ゲートウェイの種別を表す

4

gwKindゲートウェイ種別

文字列。
Stringシステム"IoTGw"

ゲートウェイ:“SystemGw”
IoT ゲートウェイ:”IoTGw”

5

6

corporationId

ifVersion

事業体 ID

インターフェイ
スバージョン

Stringゲートウェイの所有者である事業体の Id

"DUNS714005993-001"

サポートしている機器ベン
String

ダー向け標準インターフェ

1.00

イスのバージョン
サポートするデータ種別

7

dataTypeId

対応データ種別ID

ID。基本仕様書に記載されてStringいるデータ種別 ID に対応する値。基本仕様書の 4.4.1 項"00000001
00000000"を参照。
サポートするデータ種別の対応データ種別
8

dataTypeKey

プライマリー
キープロパティ

データを一意に特定するプ
String

ロパティ名。
複数ある場合は、カンマで区

名

protocolプロトコル種別

Id"切る。
ゲートウェイが水道標準プ

9"facility

String

ラットフォームに対して、送信時に使用する通信プロト
コル。

"MQTT"or"HTTP"

ゲートウェイがサポートす10

contentType

対応コンテンツタイプ

Stringるコンテンツタイプ一覧

applicati

複数項目がある場合は、カン

on/xmlマで区切る。
103
WPSC003-Ed.1.1 2021-02

機器ベンダー向け標準インターフェイス(デバイス) フォーマット例
定周期監視のデータの要求フォーマット例 (MQTT)
MQTT で定周期監視する際のデータの要求のメッセージ例を以下に示す(図 5-1)。

<?xml version="1.0" encoding="utf-8"?><CPS-IfElement><CPS-IfHeader><X-CPS-dataTypeId>0200000200000000</X-CPS-dataTypeId>← データ種別<X-CPS-Operation>POST</X-CPS-Operation >← 操作種別 ID<X-CPS-Source-ID>03-monitoringApp.1</X-CPS-Source-ID>← 依頼元情報<Content-type>application/xml</Content-type>← 入出力形式<X-CPS-Timestamp>2017-05-01T00:00:04.000Z</X-CPS-Timestamp>← タイムスタンプ<X-CPS-monitoringRequestId>REQ00005</X-CPS-monitoringRequestId> ← 監視要求 ID
MQTT</CPS-IfHeader>
プロトコル<CPS-IfBody>
ボディ<Data>
水道 CPS データプロファイル仕様書の 2.4.1 項を参照</Data></CPS-IfBody></CPS-IfElement>
図 5-1: 定周期監視のデータの要求フォーマット例 (MQTT)

定周期監視のイベントデータフォーマット例 (HTTP(S))
HTTP(S)で定周期監視する際のイベントデータのメッセージ例を以下に示す(図 5-2)。

POST /sbi/v1/results_data/ HTTP/1.1 ← リクエスト メソッド
Host:www.******.***← データ種別X-CPS-dataTypeId: 0200000200000000← 操作種別 ID
X-CPS-Operation: POST
← 依頼元情報X-CPS-Source-ID: 03-monitoringApp.1
Content-type: application/xml;charset=utf-8 ← 入出力形式← データ分割X-CPS-Data-Split: 001-001← タイムスタンプ
X-CPS-Timestamp: 2017-05-09T14:25:36.302Z← 監視要求 ID
X-CPS-monitoringRequestId: REQ00005← 実行結果コード
X-CPS-Result: 0
空白行<?xml version="1.0" encoding="utf-8"?>
水道 CPS データプロファイル仕様書の 2.4.1 項を参照

HTTP
プロトコル
ヘッダ

HTTP
プロトコル
ボディ

図 5-2: 定周期監視のデータの応答フォーマット例 (HTTP(S))- 以上 -

104
WPSC003-Ed.1.1 2021-02