Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

/api/reports/:id

Shows detailed information about the report with the specified ID.

Resource Information

Request Parameters

Parameters

Detail

Example

id

ID of the report to fetch. You can find the ID in the response to /api/reports.

123

Response Structure

JSON response contains one JSON object with following elements:

Name
Description
idReport identifier
nameReport name
localizationLocalization object that contains key-value pairs, where key is code of supported language and value is localized report name.
descriptionReport description
ownerOwner's full name
lastChangeDate and time of last change
tabs

Array of tabs inside the report with following structure

NameDescription
nameName of the tab
viewsArray containing IDs of the views inside the tab
views

Array of views where each view has following structure:

Name
Description
idView identifier
nameView name
typeView type - please see list of supported values.
localizationLocalization object that contains key-value pairs, where key is code of supported language and value is localized view name.
isFavouriteBoolean flag indicating if view is marked as favourite
dateTimeDefinition

(Optional) Applied date and time definition with following structure:

NameDescription
timeSupportedBoolean flag indicating if time is supported.
timeInterval

(Optional) Time interval to filter values. Has following structure:

NameDescription
aggregatedBoolean flag indicating if values are aggregated.
aggregationTypeTime interval period - please see list of supported values.
interval

Interval definition with following structure:

NameDescription
typeInterval type - please see list of supported values.
fromInterval start value
toInterval end value
dateSupportedBoolean flag indicating if date is supported.
dateInterval

(Optional) Date interval to filter values. Has following structure:

NameDescription
aggregatedBoolean flag indicating if values are aggregated.
aggregationTypeDate interval period - please see list of supported values.
interval

Interval definition with following structure:

NameDescription
typeInterval type - please see list of supported values.
fromInterval start value
toInterval end value



filter

(Optional) Applied filter with following structure:

NameDescription
drilldown

Drilldown defined with attribute code and following structure:

NameDescription
opFilter operation type - please see list of supported values.
value/values
(Optional) Depends on selected "op". Contains value or values for filter.
dataSet

Source data set

Name
Description
idData set identifier
nameData set name
descriptionData set description
ownerOwner's full name
lastChangeDate and time of last change
dateSupportedBoolean flag indicating if date is supported
timeSupportedBoolean flag indicating if time is supported
drilldownAttributesArray of drilldown attributes

Sample Request / Response

Using curl:

Code Block
curl -H "Authorization: OAuth realm=\"https://service.belladati.com/\", oauth_consumer_key=\"myConsumer\", oauth_token=\"mh7an9dkrg59\", oauth_timestamp=\"135131231\", oauth_nonce=\"randomString\"" https://service.belladati.com/api/reports/123

The JSON format response:

Code Block
javascript
javascript
{
  "id" : 123,
  "name" : "My Report",
  "localization" : {
    "de" : "Der Report"
  },
  "description" : "This is a report description",
  "owner" : "John Smith",
  "tabs": [
        {
            "name": "First tab",
            "views": [
                "l2nuOY1ocA"
            ]
        },
        {
            "name": "Second tab",
            "views": [
                "wK4g3gmezs"
            ]
        }
    ],
  "lastChange" : "Tue, 22 May 2012 17:16:31 GMT",
  "views" : [
    {
      "id" : 302-xB0Klm6c1L,
      "type" : "chart",
      "name" : "My View name",
      "localization" : {
        "de" : "Der lokalisierte Name"
      },
      "isFavourite" : false,
      "dateTimeDefinition" : {
        "timeSupported" : true,
        "dateSupported" : true,
        "timeInterval" : {
          "aggregationType" : "SECOND",
          "interval" : {
            "from" : {
              "hour" : "13",
              "minute" : "38",
              "second" : "0"
            },
            "to" : {
              "hour" : "21",
              "minute" : "48",
              "second" : "0"
            },
            "type" : "absolute"
          },
          "aggregated" : false
        },
        "dateInterval" : {
          "aggregationType" : "DAY",
          "interval" : {
            "from" : {
              "month" : "8",
              "year" : "2012",
              "day" : "7"
            },
            "to" : {
              "month" : "7",
              "year" : "2015",
              "day" : "14"
            },
            "type" : "absolute"
          }
        }
      },
      "filter": {
        "drilldown": {
          "L_USER": {
            "values": [
              "john"
            ],
            "op": "IN"
          }
        }
      }
    }
  ],
  "dataSet" : {
    "id" : 1234,
    "name" : "Data set name",
    "description" : "This is a data set description",
    "owner" : "John Smith",
    "lastChange" : "Thu, 08 Oct 2015 11:43:40 GMT",
    "timeSupported" : true,
    "dateSupported" : true,
    "drilldownAttributes" : [ ]
  }
}
Sv translation
languageja

/api/reports/:id

指定されたIDを持つレポートの詳細情報を表示します。

リソース情報

リソースURL 

https://service.belladati.com/api/reports/:id

HTTPメソッド

GET

リクエストパラメーター

パラメーター

詳細

id

レポートのIDをフェッチします。/api/reportsに応じて、IDを見つけることができます。

123

レスポンス構造

JSONレスポンスは、次の要素ように1 つのJSONオブジェクトが含まれます。

説明
idレポートの識別子
nameレポート名
localizationローカライゼーションオブジェクトはキーがサポートされている言語と値ローカライズされたレポート名のコードがある場合、キー-値のペアが含まれます。
descriptionレポートの説明
owner所有者のフルネーム
lastChange最後変更の時間と日付
views

各ビューの配列が以下のように構造があります:

説明
idビュー識別子
nameビュー名
typeビュータイプ  -  サポートされている値のリストを参照してください。
localizationローカライゼーションオブジェクトはキーがサポートされている言語と値ローカライズされたビュー名のコードがある場合、キー-値のペアが含まれます。
isFavouriteビューがお気に入りとしてマークされているかどうかを示すブールフラグ
dateTimeDefinition

(任意)以下の構造の日時定義を適用:

説明
timeSupportedBooleanフラグは時間がサポートされている場合にを示します。
timeInterval

(任意)値をフィルタリングする時間間隔。構造は次の通りです:

説明
aggregatedBooleanフラグは値を集計している場合に示します。
aggregationTypeタイムインターバル期間は - サポートされる値のリストをご参照してください。
interval

構造のインターバルの定義が次通りです:

説明
typeインターバルタイプ - サポートされている値のリストをご参照してください。
fromインターバル開始値
toインターバル終了値



dateSupportedBooleanフラグは日付がサポートされている場合に示します。
dateInterval

(任意)値をフィルタリングする日付間隔。構造は次の通りです:

説明
aggregatedBooleanフラグは値を集計している場合に示します。
aggregationType日付インターバル期間 - サポートされる値のリストをご参照してください。
interval

構造のインターバルの定義が次の通りです:

説明
typeインターバルタイプ - サポートされている値のリストをご参照してください。
fromインターバル開始値
toインターバル終了値




filter

(任意)フィルタが次のような構造を持つ適用されます:

説明
drilldown

属性コードとそれに続く構造で定義されたドリルダウン:

説明
opフィルタ操作タイプ - サポートされている値のリストをご参照してください。
value/values
(任意)選択した「op」に依存する。フィルタの値または値を格納します。




dataSet

ソースデータセット

説明
idデータセット識別子
nameデータセット名
descriptionデータセットの説明
owner所有者のフルネーム
lastChange最後変更の時間と日付
dateSupportedBooleanフラグは日付がサポートされている場合に示します
timeSupportedBooleanフラグは時間がサポートされている場合に示します
drilldownAttributesドロップダウン属性の配列


サンプルリクエスト/レスポンス

Curl使用:

Code Block
curl -H "Authorization: OAuth realm=\"https://service.belladati.com/\", oauth_consumer_key=\"myConsumer\", oauth_token=\"mh7an9dkrg59\", oauth_timestamp=\"135131231\", oauth_nonce=\"randomString\"" https://service.belladati.com/api/reports/123

JSONフォーマットの応答:

Code Block
javascript
javascript
{
  "id" : 123,
  "name" : "My Report",
  "localization" : {
    "de" : "Der Report"
  },
  "description" : "This is a report description",
  "owner" : "John Smith",
  "lastChange" : "Tue, 22 May 2012 17:16:31 GMT",
  "views" : [
    {
      "id" : 24530,
      "type" : "chart",
      "name" : "My View name",
      "localization" : {
        "de" : "Der lokalisierte Name"
      },
      "isFavourite" : false,
      "dateTimeDefinition" : {
        "timeSupported" : true,
        "dateSupported" : true,
        "timeInterval" : {
          "aggregationType" : "SECOND",
          "interval" : {
            "from" : {
              "hour" : "13",
              "minute" : "38",
              "second" : "0"
            },
            "to" : {
              "hour" : "21",
              "minute" : "48",
              "second" : "0"
            },
            "type" : "absolute"
          },
          "aggregated" : false
        },
        "dateInterval" : {
          "aggregationType" : "DAY",
          "interval" : {
            "from" : {
              "month" : "8",
              "year" : "2012",
              "day" : "7"
            },
            "to" : {
              "month" : "7",
              "year" : "2015",
              "day" : "14"
            },
            "type" : "absolute"
          }
        }
      },
      "filter": {
        "drilldown": {
          "L_USER": {
            "values": [
              "john"
            ],
            "op": "IN"
          }
        }
      }
    }
  ],
  "dataSet" : {
    "id" : 1234,
    "name" : "Data set name",
    "description" : "This is a data set description",
    "owner" : "John Smith",
    "lastChange" : "Thu, 08 Oct 2015 11:43:40 GMT",
    "timeSupported" : true,
    "dateSupported" : true,
    "drilldownAttributes" : [ ]
  }
}