SIDfmVM API の利用方法

リクエスト

すべてのリクエストには必ず、VM API キー設定画面で登録済みの API キーを X-API-Key としてリクエストヘッダに含めるか、パラメータに api_key として指定する必要があります。
また、エンドポイントのリクエストボディは、content-type: application/x-www-form-urlencoded である必要があります。

レスポンス

レスポンスは JSON 形式となります。
下記はカテゴリ一覧を取得するGET /categories の実行例です。

{
  "success": true,
  "response": {},
  "total_size": 1,
  "categories": [
    {
      "id": 23,
      "name": "業務 部",
      "desc": "業務部",
      "hostlim": 7,
      "is_system": false
    }
  ]
}

リクエストエラーの場合は、{ "success": false, "response": { "message": エラーメッセージ } }を返します。
下記は API キーが間違っていた場合のエラー例です。

{
  "success": false,
  "response": { "message": "invalid apikey" }
}