RIPコンフィギュレーションファイルの追加・更新
RIPコンフィギュレーションは、ComputerGUIDで識別される特定のコンピュータにリンクされています。 を持つRIPコンフィグレーションファイルがある場合、そのファイルは コンピュータGUID が見つかった場合，RIPコンフィグレーションファイルが更新され，そうでない場合は新しいRIPコンフィグレーションファイルが追加されます。
のURLです。
POST http://api.aurelon.com/api/v2/
コンフィギュレーション
リクエストヘッダ。
コンテンツ-タイプ : multipart/form-data
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
リクエストの本文です。
フォームデータ1：必須
-
- 名前JsonString
- Content-Type: application/json
- {“ComputerGUID”:”00000000-0000-0000-0000-000000000000″} ComputerGUIDとして、RIPコンピュータのGUIDが渡されます。
フォームデータ2：必須
-
- 名前RIP.xml (入力ファイル要素は任意の名前)
- Content-Type: application/xml
- コンフィギュレーションのXMLファイル
対応する。
レスポンスのコンテンツタイプはJSON形式です
成功です。
- 200 OK : “コンフィギュレーションが正常に追加されました”
エラーです。
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 415 サポートされていないメディアタイプ : {“Message”: “This request is not properly formatted”}.
- 401 不正な: {“Message”:””HardwareHash””SerialNumber””ApplicationVersion “のヘッダーが必要です”}.
- 400 Bad Request: {“Message”: “ComputerGUID” required”}.
- 400 Bad Request（不正なリクエスト）: {“Message”: “ComputerGUID の検証に失敗しました”}.
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
XML設定ファイルの例です。
こちら
コンフィギュレーションを取得する
RIP設定ファイルをダウンロードし コンピュータガイド が見つかれば
のURLです。
GET http://api.aurelon.com/api/v2/
configuration/<ComputerGUID>
リクエストヘッダ。
MisKey : 認証を見る
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
対応する。
コンテンツタイプはapplication/xmlで、RIP ComputerのコンフィギュレーションのXMLが含まれる。 または、エラーの内容を含む場合のコンテンツタイプはapplication/jsonです。
成功です。
- 200 OK : コンフィギュレーション XML
エラーです。
- 401 認証されていません。 {“Message”:”Invalid MisKey” }.
- 401 認証されていません。 {メッセージ: “HardwareHash “ヘッダが無効です”}。
- 404 Not Found : {メッセージ”: “ComputerGUID not found”}。
- 401 認証されていません。 {“Message”:””MisKey” または “HardwareHash”, “SerialNumber” および “ApplicationVersion” ヘッダが必要です”}。
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
サイトリスト取得
シリアル番号で識別されたアクティブサイトのリストを受信します。
のURLです。
GET http://api.aurelon.com/
api/v2/configuration/sites
リクエストヘッダ。
MisKey : 認証を見る
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
対応する。
コンテンツタイプはapplication/jsonで、シリアル番号で識別される既知のサイトのJSONが含まれています。
成功です。
- 200 OK : サイトの配列
元です。
[{
“SiteGUID”:”8447e5b0-99ac-11e7-a2d0-215af4f8ef85″,
“SerialNumber”:333674,
“Location”:null。
}, {
…
}]
エラーです。
- 401 認証されていません。 {“Message”:”Invalid MisKey” }.
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 401 認証されていません。 {“Message”:””MisKey” または “HardwareHash”, “SerialNumber” および “ApplicationVersion” ヘッダが必要です”}。
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
サイトコンフィギュレーションを取得する
シリアル番号のアクティブなデバイス/キューとRIPのリストを受信します。
のURLです。
GET http://api.aurelon.com/
api/v2/configuration/site/<SerialNumber>
リクエストヘッダ。
MisKey : 認証を見る
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
対応する。
コンテンツタイプは application/json で、シリアル番号で識別されるサイトの既知の設定の JSON を含む。
成功です。
- 200 OK : コンピュータ、そのデバイス、およびそれらのキューの配列。
元です。
[{
“ComputerGUID”:”8447e5b0-99ac-11e7-a2d0-215af4f8ef85″,
“名前”: “myrip.company.domain”,
“Modified”:”2018-06-27T07:56:36Z”,
「デバイス]: [{}を
“DeviceGUID”:”6da06b44-20ee-11e6-b287-07f164aa386e”,
“名称”: “Durst Rhotex 322”,
“Modified”:”2018-06-27T07:56:36Z”,
「DriverID”:1601
}, {
…
}]
}, {
…
}]
エラーです。
- 401 認証されていません。 {“Message”:”Invalid MisKey” }.
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 404 Not Found : {“Message”: “SerialNumber not found”}.
- 401 認証されていません。 {“Message”:””MisKey” または “HardwareHash”, “SerialNumber” および “ApplicationVersion” ヘッダが必要です”}。
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
コンフィギュレーションシンク
RIPのアクティブなデバイス/キューのリストを更新します。
のURLです。
POST http://api.aurelon.com/
api/v2/configuration/sync
リクエストヘッダ。
コンテンツ-タイプ : application/json
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
リクエストの本文です。
を含むJSONオブジェクト。
- ComputerGUID – 必須 – コンピュータのGUIDです。
- デバイスリスト – required – デバイスごとのオブジェクトの配列。 含む各オブジェクト。
- DeviceGUID– 必須 – RIPでアクティブなデバイスのGUID。
- QueueList– RIP でアクティブなキューの GUIDの配列．
対応する。
操作の結果を含むコンテンツタイプapplication/json。
成功です。
- 200 OK : “コンフィギュレーションの保存に成功”
エラーです。
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 415 サポートされていないメディアタイプ : {“Message”: “This request is not properly formatted”}.
- 401 認証されていません。 {“Message”:””HardwareHash””SerialNumber””ApplicationVersion “ヘッダが必要です”}。
- 400 Bad Request（不正なリクエスト） : {“Message”: “ComputerGUID” required”}.
- 400 Bad Request（不正なリクエスト） : {“Message”: “DeviceList “フィールドは必須です”}。
- 400 Bad Request（不正なリクエスト） : {“Message”:””QueueList” フィールドは必須です”}.
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
RIPの追加・更新
を持つRIPがあれば を持つRIPがあれば、そのRIPを更新する。 を持つRIPが見つかった場合、RIPは更新され、そうでない場合は新しいRIPが追加されます。
のURLです。
POST http://api.aurelon.com/
api/v2/configuration/rip
リクエストヘッダ。
コンテンツ-タイプ : application/json
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
リクエストの本文です。
を含むJSONオブジェクト。
- ComputerGUID– 必須 – コンピュータのGUIDです。
- ComputerName – コンピュータの名前またはDNS名
- OperatingSystem – OSの種類とバージョン
対応する。
操作の結果を含むコンテンツタイプapplication/json。
成功です。
- 200 OK : “コンピュータの詳細が正常に保存されました”
エラーです。
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 415 非対応のメディアタイプ : {“Message”: “Expected type: application/json”}.
- 401 認証されていません。 {“Message”:””HardwareHash””SerialNumber””ApplicationVersion “ヘッダが必要です”}。
- 400 Bad Request（不正なリクエスト） : {“Message”: “ComputerGUID” required”}.
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
デバイスの追加・更新
を持つデバイスがあれば デバイスガイド が見つかった場合はデバイスが更新され、そうでない場合は、それがライセンスの一部であれば新しいデバイスが追加されます。 DeviceGUIDがライセンスの一部でない場合、エラーが返されます。
のURLです。
POST http://api.aurelon.com/
api/v2/configuration/device
リクエストヘッダ。
コンテンツ-タイプ : application/json
MisKey : 認証を見る
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
リクエストの本文です。
を含むJSONオブジェクト。
- DeviceGUID– 必須 – デバイスGUID
- ComputerGUID– 必須 – このデバイスがインストールされているRIP
- 名称
- タイプ
- メディアタイプ
- メディアサイズ
- メディアソース
- メーカー
- モデル
- DriverID(HUBデータベースからのユニークなドライバーID)
- コネクションURI
対応する。
操作の結果を含むコンテンツタイプapplication/json。
成功です。
- 200 OK : “デバイスの保存に成功”
エラーです。
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 401 認証されていません。 {メッセージ”: “Invalid MisKey” }.
- 404 Not Found : {“Message”: “DeviceGUID is not found”}.
- 415 サポートされていないメディアタイプ : {“Message”: “This request is not properly formatted”}.
- 401 認証されていません。 {“Message”:””MisKey” または “HardwareHash”, “SerialNumber” および “ApplicationVersion” ヘッダが必要です”}。
- 400 Bad Request（不正なリクエスト） : {“Message”: “DeviceGUID “が必要です”}.
- 400 Bad Request（不正なリクエスト） : {“Message”: “ComputerGUID” required”}.
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
キューを追加・更新する
を持つキューがあれば、そのキューは キューGUIDを持つキューがあればそのキューは更新され、そうでなければ新しいキューが追加されます。
のURLです。
POST http://api.aurelon.com/
api/v2/configuration/queue
リクエストヘッダ。
コンテンツ-タイプ : application/json
MisKey : 認証を見る
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
リクエストの本文です。
を含むJSONオブジェクト。
- QueueGUID– 必須 – キューのGUIDです。
- DeviceGUID– 必須
- プロフィール名
- 名称
- メディアタイプ
- メディアサイズ
- メディアソース
- キュータイプ
- ドライバ設定
対応する。
操作の結果を含むコンテンツタイプapplication/json。
成功です。
- 200 OK : “キューが正常に保存されました”
エラーです。
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 401 認証されていません。 {メッセージ”: “Invalid MisKey” }.
- 404 Not Found : {“Message”: “DeviceGUID is not found”}.
- 415 非対応のメディアタイプ : {“Message”: “Expected type: application/json”}.
- 401 認証されていません。 {“Message”:””MisKey” または “HardwareHash”, “SerialNumber” および “ApplicationVersion” ヘッダが必要です”}。
- 400 Bad Request（不正なリクエスト） : {“Message”: “DeviceGUID “が必要です”}.
- 400 Bad Request（不正なリクエスト） : {“Message”:””QueueGUID” required”}.
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
デバイスの削除
指定されたデバイスを削除する。
のURLです。
DELETE http://api.aurelon.com/
api/v2/configuration/device/<DeviceGUID>
リクエストヘッダ。
コンテンツ-タイプ : application/json
MisKey : 認証を見る
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
対応する。
操作の結果を含むコンテンツタイプapplication/json。
成功です。
- 200 OK : “デバイスの削除に成功”
エラーです。
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 401 認証されていません。 {メッセージ”: “Invalid MisKey” }.
- 404 Not Found : {“Message”: “DeviceGUID is not found”}.
- 401 認証されていません。 {“Message”:””MisKey” または “HardwareHash”, “SerialNumber” および “ApplicationVersion” ヘッダが必要です”}。
- 400 Bad Request（不正なリクエスト）: {“Message”: “DeviceGUID “の値が必要です”}.
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。
キューを削除する
指定されたキューを削除する。
のURLです。
DELETE http://api.aurelon.com/
api/v2/configuration/queue/<QueueGUID>
リクエストヘッダ。
コンテンツ-タイプ : application/json
MisKey : 認証を見る
HardwareHash : 認証参照
シリアルナンバー : 認証参照
アプリケーションバージョン : 認証参照
対応する。
操作の結果を含むコンテンツタイプapplication/json。
成功です。
- 200 OK : “デバイスの削除に成功”
エラーです。
- 401 認証されていません。 {“Message”: “Invalid HardwareHash”}.
- 401 認証されていません。 {メッセージ”: “Invalid MisKey” }.
- 404 Not Found : {“Message”: “QueueGUID is not found”}.
- 401 認証されていません。 {“Message”:””MisKey” または “HardwareHash”, “SerialNumber” および “ApplicationVersion” ヘッダが必要です”}。
- 400 Bad Request（不正なリクエスト） : {“Message”:””QueueGUID” value required”}.
- 500 Internal Server Error（内部サーバーエラー）: {メッセージ”: “内部サーバーエラー”}。