Postmanを使用してHTTP APIを使用して、SIP登録、DSSキー、ネットワークオプション、XML要求形式、サポートされているパラメータ取得などのデバイス設定を構成する方法を学びます。
このガイドでは、HTTP API を介したデバイスパラメータの設定方法（SIPサーバー設定、SIPアカウント登録情報、DSSキーパラメータ、その他のデバイスオプションを含む）について説明します。デバイスはHTTPサーバーとして動作し、クライアントは特定のHTTPリクエストを送信して設定変更を適用します（下図参照）。
この例では、Postman を使用してデバイスに送信される HTTP リクエストをシミュレートします。
当社製品ラインの現在利用可能なすべての電話モデル。
① 最新のファームウェアバージョンにアップグレードされ、PoEスイッチに接続された BHP-SOS11V インターホンデバイス 1 台。
② Postman がインストールされた設定用 PC 1 台。同じスイッチに接続され、正常なネットワーク通信が確認されていること。
Postman は以下からダウンロードします：
https://www.postman.com/downloads/
その後、インストール手順に従ってセットアップを完了します。
File – New をクリックし、HTTP Request を選択します。
新しいリクエストウィンドウで、POST メソッドを選択し、次の形式でデバイスの HTTP URL を入力します：
http://ip/xmlservice
URL は大文字と小文字を区別することに注意してください。ip を実際のデバイス IP アドレスに置き換えます（下図参照）。
次に、必要な HTTP リクエストパラメータを設定します：
認証方法：Basic Auth
ヘッダー：Content-Type: xml/text
Body をクリックし、raw を選択して、メッセージボディに XML コンテンツを入力します。サンプル形式を以下に示します。
構造は次のとおりです：
これは XML 宣言ヘッダーであり、すべてのリクエストで必要です。
これは XML コマンド構造を定義します。cmd 属性は、現在のパラメータを取得する get または新しいパラメータを書き込む set のいずれかです。
これは実際の設定項目を指定します。この例では、リクエストはデバイスから SIP ライン関連のパラメータを取得します。
実際の使用では、次のセクションを、実際に照会または設定するパラメータに応じて調整する必要があります：
モデルによってサポートされる HTTP API パラメータは異なる場合があります。以下のいずれかの方法を使用して、特定のデバイスでサポートされるパラメータリストを取得できます。
方法 1： デバイスの WEB インターフェースで、System – System Configuration に移動し、nc タイプの設定ファイルをエクスポートします。
右クリックしてファイルを保存するか、左クリックして設定を直接表示できます。一般的なパラメータは次のセクションにリストされています。
方法 2： 一部のモデルでは、Web インターフェースに nc 設定ファイルのリンクが直接提供されていません。その場合は、ブラウザのアドレスバーに対応する URL を入力して、nc 設定ファイルを手動で取得できます。
注意：この方法は応答に時間がかかる場合があります。
このセクションでは、参考として一般的なパラメータをいくつかリストします。将来のアップデートでより多くのパラメータが追加される可能性があります。
SIP ラインパラメータの例（i30 アクセス制御デバイスより）：
sip.line.1.PhoneNumber = 112
sip.line.1.DisplayName = 112
sip.line.1.SipName =
sip.line.1.RegAddr = 172.18.1.45
sip.line.1.RegPort = 2066
sip.line.1.RegUser = 112
sip.line.1.RegPswd = abc123
sip.line.1.RegTTL = 3600
sip.line.1.RegEnabled = 0
sip.line.1. は、これらのパラメータが SIP ライン 1 に属することを示します。
PhoneNumber は Web インターフェースの電話番号フィールドに対応します。
DisplayName は表示名に対応します。
RegAddr は SIP プロキシサーバーアドレスです。
RegPort は SIP プロキシサーバーポートです。
RegUser は認証ユーザー名で、通常は電話番号と同じです。
RegPswd はパスワードです。
RegTTL は登録有効期限で、デフォルト値は 3600 秒です。
RegEnabled はラインが有効かどうかを定義します：0 は無効、1 は有効を意味します。
i30 の DSS キーパラメータの例：
まず Web インターフェースで DSS キーを設定し、次に get コマンド付きの HTTP API を使用して対応するパラメータ値を読み戻し、正確なマッピングを確認することをお勧めします。
Type=1 は、i30 や i12 などのデバイスの DSS キータイプが Hotkey であることを示します。他のモデルの場合は、上記の推奨方法を使用して実際のタイプ値を確認してください。
Value=125@1/f の意味：
125 = 宛先番号
@1 = ライン 1
/f = サブタイプ：スピードダイヤル
i30 や i12 などのデバイスのネットワークパラメータの例：
WANMode はネットワークモードを示し、DHCP または static のいずれかです。このパラメータは set コマンドで直接書き込むことはできません。dhcp.Enabled の値に応じて自動的に変化します。
static.IP は静的 IP アドレスです。デバイスが静的モードの場合にのみ有効です。DHCP モードでは、get コマンドを使用して現在の IP アドレスを取得できます。
static.SubnetMask はサブネットマスクです。
static.Gateway はデフォルトゲートウェイです。
static.PrimaryDNS はプライマリ DNS サーバーです。
static.SecondaryDNS はセカンダリ DNS サーバーです。
dhcp.Enabled は DHCP が有効かどうかを定義します：1 は DHCP モードがアクティブであることを意味し、0 は静的 IP モードが使用されていることを意味します。
BHP-SOS11V の音量パラメータの例：
phone.volume.HandFreeVol はハンズフリー音量です。範囲は 1-9 で、9 が最大音量です。
phone.volume.HandFreeRingVol は着信音の音量です。範囲は 1-9 で、9 が最大音量です。
phone.volume.HandFreeToneVol はアラートや通知音などのプロンプトトーンの音量です。範囲は 1-9 で、9 が最大音量です。
システム情報パラメータは読み取り専用です。つまり、get コマンドでのみ照会できます。
例：
このパラメータはすべてのシステム情報を返します。特定の項目のみが必要な場合は、パラメータパスを次のノードレベルまで拡張します。
例えば、デバイスの MAC アドレスを取得する場合：
