API Try-it ガイド
API リファレンスの各製品ページには Playground(Try-it) コンソールが併せて提供されます。ブラウザーから装置の REST API を直接呼び出して応答を確認でき、各オペレーションには copy-as-curl(cURL コマンドのコピー)ボタンがあるため、直接呼び出しが難しい環境でも同一のリクエストをターミナルで実行できます。
1. 装置アドレスの入力
Playground 上部のサーバー変数 device_ip に対象装置の IP(例: 192.168.0.30)を入力してください。装置が API を直接提供するため、同じネットワーク(または P2P 直結)内でアクセスできるアドレスである必要があります。
2. ブラウザーのサポート
| ブラウザー | ブラウザーからの直接呼び出し | 条件 |
|---|---|---|
| Chrome / Edge 142+ | 可能 | プライベート IP を対象に初回 1 回だけ ローカルネットワークアクセス(LNA)権限を許可した後 |
| Firefox 149/151+ | おおむね可能 | 同一の LNA モデル、段階的にロールアウト中 |
| Safari | 不可 | プライベートネットワークの mixed content をブロック — copy-as-curl を使用 |
💡 参考: 本ドキュメントサイトは HTTPS で、装置の API はプライベートネットワークの HTTP です。Chrome/Edge 142+ はプライベート IP リテラルを対象とする場合に mixed content を自動的に免除し、初回 1 回だけ ローカルネットワークアクセス(LNA)権限のプロンプトを表示します。許可すると、以降は正常に呼び出せます。
3. 直接呼び出しがブロックされる場合 — copy-as-curl フォールバック
Safari や旧バージョンのブラウザーである場合、または認証(Basic Auth)を含むクロスオリジンリクエストがブラウザーのポリシーによってブロックされる場合は、各オペレーションの copy-as-curl ボタンで cURL コマンドをコピーし、ターミナルで実行してください。すべてのブラウザー・環境で同一に動作します。
curl -u admin:<password> http://192.168.0.30/setting/status4. トラブルシューティング
-
LNA のプロンプトが表示されない、または拒否した場合 → ブラウザーのサイト権限でローカルネットワークアクセスを許可してください。
-
Safari はプライベートネットワークの mixed content をブロックするため、直接呼び出しはできません → copy-as-curl を使用してください。
-
認証が必要なリクエストでは、ユーザー名・パスワードを入力してください。装置の初期アカウントは、初回接続時に必ず変更する必要があります。