You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

/api/dataSets/:id

Shows detailed information about the data set with the specified ID.

Resource Information

Resource URL

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

HTTP Method

GET

Request Parameters

Parameters

Detail

id

ID of the data set to fetch. You can find the ID in the response to /api/dataSets. 
Example: 123

Response Structure

NameDescription
idData set identifier
nameData set name
localizationLocalization object that contains key-value pairs, where key is code of supported language and value is localized data set name.
descriptionData set description
ownerOwner's full name
lastChangeDate and time of last change
attributes

Array of attributes

NameDescription
idAttribute identifier
nameAttribute name
typeAttribute type - one of following values: String, Numeric, Integer, Boolean, Date, Time, DateTime, Text, JSON, GeoJSON, Point
codeAttribute code
indicators

Array of indicators

NameDescription
idIndicator identifier
nameIndicator name
typeIndicator type - one of following values: DATA_INDICATOR, FORMULA_INDICATOR, INDICATOR_GROUP
codeOnly if "type" has value "DATA_INDICATOR". Indicator code
formulaOnly if "type" has value "FORMULA_INDICATOR". Indicator formula


reports

Array of reports

NameDescription
idReport identifier
nameReport name
descriptionReport description
ownerOwner's full name
lastChangeDate and time of last change


Sample Request / Response

Using curl:

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/dataSets/123

The JSON format response:

{
  "id" : 123,
  "name" : "My test data set",
  "localization" : {
    "de" : "Deutsch Name"
  },
  "description" : "This is a sample data set.",
  "owner" : "John Smith",
  "lastChange" : "Tue, 22 May 2012 17:16:31 GMT",
  "attributes" : [
    {
      "id" : 24530,
      "name" : "City",
      "code" : "L_CITY",
      "type" : "String"
    }
  ],
  "indicators" : [
    {
      "id" : 24531,
      "name" : "Count",
      "type" : "DATA_INDICATOR",
      "code" : "M_COUNT"
    },
    {
      "id" : 24532,
      "name" : "Calculated indicator",
      "type" : "FORMULA_INDICATOR",
      "formula" : "M_COUNT * 1000"
    },
    {
      "id" : 24533,
      "name" : "Indicator group",
      "type" : "INDICATOR_GROUP"
    }
  ],
  "reports" : [
    {
      "id" : 7497,
      "name" : "My Report",
      "description" : "This is a sample report.",
      "owner" : "John Smith",
      "lastChange" : "Mon, 16 Apr 2012 10:17:26 GMT"
    }
  ]
}
  • No labels