REST / HTTPS
クラウドとローカルゲートウェイで統一 API スタイル、JSON データ交換
ピュアポイント・スマート 開発者プラットフォームは、インテグレーター、PMS/CRS ベンダー、ISV 向けに標準化された RESTful API とオープン SDK を提供 — デバイス接続、客室ステータス、シーン制御、エネルギーデータ、イベント購読をカバー。クラウドまたはローカルゲートウェイ経由で、ピュアポイント・スマート 客室制御をホテル運用・ビル管理システムに迅速に組み込めます。
プラットフォーム機能
-
RESTful API
HTTPS 上の JSON リクエスト/レスポンス、バージョン付きパス — フロント/バックエンド・第三者システムとの連携が容易。
-
多言語 SDK
Java / Python / Node.js サンプルと署名ユーティリティで、連携・本番稼働サイクルを短縮。
-
Webhook イベント
客室ステータス変更、アラート、シーン実行結果を能動的にプッシュ — リトライと署名検証付き。
-
サンドボックス
本番前の連携・負荷検証用の独立テストテナントとシミュレートデバイス（申請で有効化）。
API モジュール
業務ドメイン別にインターフェースを整理、スコープ付き認可に対応。フィールド定義とレート制限は正式ドキュメントに準拠。
-
デバイスとポイント
RCU、パネル、センサーのオンライン状態を照会。ポイント値、デジタル/アナログ I/O の読み書き。
-
客室とステータス
チェックイン/アウト、DND、MUR、SOS 等の客室状態を同期。PMS 客室番号にマッピング。
-
シーンと連動
ウェルカム、不在時電源オフ、会議モード等のシーンをトリガー。実行結果と失敗理由を照会。
-
エネルギーとレポート
客室/フロア/共用部別に電力・空調データを集計。レポートインターフェースをエクスポート。
-
アラートと運用
デバイスオフライン、通信異常、負荷アラートを購読。チケットシステムと連携。
-
プロジェクトと権限
複数ホテル/プロジェクトのテナント分離。AppKey、ロール、API スコープ管理。
クイックスタート
-
開発者アカウント登録
営業またはサポート経由で連携申請を提出し、AppKey / AppSecret を取得。
-
コールバック URL 設定
開発者コンソールで Webhook URL を登録し、客室ステータスとアラートイベントを受信。
-
サンドボックス連携
テストプロジェクト ID で API を呼び出し、署名、認証、業務フィールドを検証。
-
本番稼働
検収後に本番クレデンシャルに切り替え、SLA に沿って呼び出し量とエラー率を監視。
主要エンドポイント
典型的な REST パスの例。完全な OpenAPI 仕様はダウンロードセンターから取得。
| メソッド | パス | 説明 |
|---|---|---|
| POST | /v1/oauth/token | アクセストークン取得（Client Credentials） |
| GET | /v1/projects/{id}/rooms | ページ分割客室一覧とステータス概要 |
| GET | /v1/projects/{id}/rooms/{roomNo}/devices | 指定客室のデバイスとオンライン状態 |
| PUT | /v1/projects/{id}/rooms/{roomNo}/scene/{sceneId} | シーントリガー（ウェルカム、不在時電源オフ等） |
| POST | /v1/projects/{id}/rooms/{roomNo}/points | ポイント一括書き込み（スイッチ、調光、空調設定等） |
| GET | /v1/projects/{id}/energy/summary | 期間指定のエネルギー集計 |
| POST | /v1/webhooks/subscriptions | Webhook 購読登録（客室ステータス、アラート等） |
プロトコルとエコシステム
HTTP API に加え、フィールドバスと第三者プラットフォームに対応し、ホテル・ビルの多様な連携ニーズを満たします。
BACnet / Modbus
BMS、HVAC、メーター等サブシステムのプロトコル変換
MQTT
低帯域幅シナリオでのデバイス報告とコマンド配信
KNX / エコシステムプラグイン
KNX、Home Assistant 等の相互接続ソリューションと連携
オンボーディング手順
申請提出
連携シナリオ、想定呼び出し量、稼働予定時期を記載
クレデンシャル発行
サンドボックスと本番環境キーを割り当て
連携テスト
テクニカルサポートが API と Webhook テストを支援
本番稼働
本番に切り替え、運用監視に組み込み
よくある質問
API キーの取得方法は？
契約インテグレーターと戦略顧客向け。営業またはサポート経由で連携概要を提出し、承認後に開発者コンソールでアプリを作成して AppKey、AppSecret を取得。
ローカルゲートウェイ展開は可能？
はい。大規模ホテルグループはローカルエッジゲートウェイで、オフライン・低遅延シナリオでもクラウドと同等の API を提供可能。アーキテクチャはプロジェクトごとに定義。
レート制限はある？
アプリごとにデフォルト QPS と日次クォータ。大規模プロジェクトは引き上げ申請可。超過時は 429 を返却 — 指数バックオフを実装してください。
Webhook のセキュリティは？
イベントペイロードに HMAC 署名とタイムスタンプ付き。署名を検証し、古いリクエストを拒否。HTTPS エンドポイント推奨。IP 許可リストは要望に応じて設定可。
クラウドプラットフォームとの違いは？
クラウドプラットフォームはスタッフ向けの視覚的運用。開発者 API はシステム連携・自動化向け — PMS、CRM、エネルギープラットフォーム等。併用可能。
現地研修またはアフターサポートが必要ですか？
API 連携研修、プロジェクト検収コーチング、ライフサイクル全体のテクニカルサポートを提供します。
