{"info":{"_postman_id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","name":"Enerbrain External APIs","description":"

Enerbrain External APIs

\n

This Enerbrain External API layer is designed for server-to-server communication.

\n

Authentication and Authorization is handled via an API Key.

\n

In order to avoid an inappropriate use of the Enerbrain External APIs, rate limits have been set.

\n

In particular, each client can make:

\n\n

API key should be added in the header

\n

Authorization

\n

This is an example of Authorization argument:

\n
'x-api-key': '5tBrejtV9sYat5vcfWn2NPErUtFPmZwMErDMpxNWhzW4eShyL6S6qv2cyWRX3KJzn7UkNAWRLpfB6REC5sTHRmAyHnpcG4ZccUuJZjNz6qzWcBFJTuxHvyHZfxRzGVEk'\n\n

API keys are given by Enerbrain only and are linked to a set of Buildings.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Enerbrain External APIs","slug":"enerbrain-external-apis"}],"owner":"8187555","collectionId":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","publishedId":"SVtN4Xba","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2021-04-16T15:04:54.000Z"},"item":[{"name":"Add Consumption Data","id":"ba5a7ff6-b6e7-4df1-9bfa-be72950bbdf6","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"consumption\":\r\n [\r\n {\r\n \"deviceId\": \"ooF\",\r\n \"registerDesc\": \"Foo\",\r\n \"comms\": [\r\n {\r\n \"timestamp\": 1603843201,\r\n \"value\": 101\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://external-api.enerbrain.com/v2/consumption/","description":"

Add Consumption Data allows the user to insert historical consumption data.

\n

An Enerbrain's consumption object is stored using this formalism:

\n
{\n    \"deviceId\": String (unique),\n    \"registerDesc\": String,\n    \"comms\": [\n        {\n             \"timestamp\": Integer (Unix Timestamp),\n             \"value\": Number\n        }\n     ]\n}\n
\n

The call to these functions requires an authorization header based on the x-api-key parameter.

\n

Guidelines for data ingestion

\n
    \n
  1. deviceId, must be a unique value
    2. \n
  2. registerDesc, should be a unique value. This field is the name of a register into the Enerbrain's Dashboard.
    3. \n
  3. deviceId and registerDesc together are a primary key, so this couple must be unique.
    4. \n
  4. If the user doesn't have a deviceId it's mandatory to use registerDesc for both fields.
    5. \n
  5. The only measure of the value is the kWh
    6. \n
  6. The list of value must be incremental.
    7. \n
  7. If you want to use different units of measurement, you have to agree with the Enerbrain Development Team (multiplier)
    8. \n
  8. The size of the JSON object must be at most 100MB
    9. \n
\n

Example\n

\n
https://external-api.enerbrain.com/v2/consumption/\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","name":"Enerbrain External APIs","type":"collection"}},"urlObject":{"protocol":"https","path":["v2","consumption",""],"host":["external-api","enerbrain","com"],"query":[],"variable":[]}},"response":[{"id":"a5d78007-772d-41f0-8ff3-2818e78318dc","name":"Add Consumption Data - Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"consumption\":\r\n [\r\n {\r\n \"deviceId\": \"ooF\",\r\n \"registerDesc\": \"Foo\",\r\n \"comms\": [\r\n {\r\n \"timestamp\": 1603843201,\r\n \"value\": 101\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://external-api.enerbrain.com/v2/consumption"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"387"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 28 Oct 2020 12:17:45 GMT"},{"key":"x-amzn-RequestId","value":"464d697d-6266-40ea-9717-ebf6abf02620"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Origin, Content-Type, Authorization"},{"key":"x-amz-apigw-id","value":"VHwoaEk4joEFaqQ="},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, PATCH, OPTIONS"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5f996168-526f51ff1eb23c081078fe2f;Sampled=0"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 af99c3a89a763b28315bf37a304c4f2c.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MXP64-C1"},{"key":"X-Amz-Cf-Id","value":"VHK2xvb6F4HMJJc8bfel-OwPg9L8snhTf79N8NDQEQFV0cs_iCM27A=="}],"cookie":[],"responseTime":null,"body":"{}"},{"id":"952ad901-1c77-4d0b-8e6d-ff864eba4c6c","name":"Add Consumption Data - Wrong Api Key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"consumption\":\r\n [\r\n {\r\n \"deviceId\": \"ooF\",\r\n \"registerDesc\": \"Foo\",\r\n \"comms\": [\r\n {\r\n \"timestamp\": 1603843201,\r\n \"value\": 101\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://external-api.enerbrain.com/v2/consumption"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"387"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 28 Oct 2020 12:18:09 GMT"},{"key":"x-amzn-RequestId","value":"5fdba97b-422c-483a-9598-7aed612ed89d"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Origin, Content-Type, Authorization"},{"key":"x-amz-apigw-id","value":"VHwr-FuAjoEFV4w="},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, PATCH, OPTIONS"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5f99617f-152af8805a973f046996451a;Sampled=0"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 af99c3a89a763b28315bf37a304c4f2c.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MXP64-C1"},{"key":"X-Amz-Cf-Id","value":"n9qM-imP69gDupIsfBgwmaHOuez42mOgZrH0Nr6MOLLtFNUmYvd9nQ=="}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Forbidden\"\n}"},{"id":"f96961a4-9038-46fa-8ec0-ed1aa27741e3","name":"Add Consumption Data - Unauthorized","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"consumption\":\r\n [\r\n {\r\n \"deviceId\": \"ooF\",\r\n \"registerDesc\": \"Foo\",\r\n \"comms\": [\r\n {\r\n \"timestamp\": 1603843201,\r\n \"value\": 101\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://external-api.enerbrain.com/v2/consumption"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"41"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 28 Oct 2020 12:18:28 GMT"},{"key":"x-amzn-RequestId","value":"f31aa185-aae4-43d4-ad9b-25fa29f5774c"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Origin, Content-Type, Authorization"},{"key":"x-amz-apigw-id","value":"VHwvPHKKDoEFt_g="},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, PATCH, OPTIONS"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5f996194-1d0fd03f432404e514de3a1b;Sampled=0"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 af99c3a89a763b28315bf37a304c4f2c.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MXP64-C1"},{"key":"X-Amz-Cf-Id","value":"Qtl7QDul7teEFOsM8SJEJH1Q-6-zu4EpxQij2e4G_ERL1Um_JQEfFA=="}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized: You are not authorized to insert data.\"\n}"}],"_postman_id":"ba5a7ff6-b6e7-4df1-9bfa-be72950bbdf6"},{"name":"Add Sensors Data","id":"1b7d4fbe-5643-4868-acbb-f7b4c6d45ede","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"sensors\":\n [\n {\n \"deviceId\": \"123ABC\",\n \"comms\": [\n {\n \"timestamp\": 1603843202,\n \"type\": \"tc\",\n \"value\": 23\n },\n {\n \"timestamp\": 1603843202,\n \"type\": \"co2\",\n \"value\": 650\n },\n {\n \"timestamp\": 1603843202,\n \"type\": \"rh\",\n \"value\": 30\n }\n ]\n }\n ]\n}"},"url":"https://external-api.enerbrain.com/v2/sensors/","description":"

Add Sensors Data allows the user to insert historical environmental data.

\n

An Enerbrain's sensors object is stored using this formalism:

\n
{\n   \"deviceId\": String (UNIQUE),\n   \"comms\": [\n      {\n        \"timestamp\": Integer,\n        \"type\": String,\n        \"value\": Number\n      }\n   ]\n}\n
\n

The call to these functions requires an authorization header based on the x-api-key parameter.

\n

Guidelines for data ingestion

\n\n

Example\n

\n
https://external-api.enerbrain.com/v2/sensors/\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","name":"Enerbrain External APIs","type":"collection"}},"urlObject":{"protocol":"https","path":["v2","sensors",""],"host":["external-api","enerbrain","com"],"query":[],"variable":[]}},"response":[{"id":"4a8e3c46-27e1-4b4b-bd16-58f864ff6c2f","name":"Add Sensors Data - Success","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"sensors\":\r\n [\r\n {\r\n \"deviceId\": \"123ABC\",\r\n \"comms\": [\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"tc\",\r\n \"value\": 23\r\n },\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"co2\",\r\n \"value\": 650\r\n },\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"rh\",\r\n \"value\": 30\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://external-api.enerbrain.com/v2/sensors"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"387"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 28 Oct 2020 12:17:45 GMT"},{"key":"x-amzn-RequestId","value":"464d697d-6266-40ea-9717-ebf6abf02620"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Origin, Content-Type, Authorization"},{"key":"x-amz-apigw-id","value":"VHwoaEk4joEFaqQ="},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, PATCH, OPTIONS"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5f996168-526f51ff1eb23c081078fe2f;Sampled=0"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 af99c3a89a763b28315bf37a304c4f2c.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MXP64-C1"},{"key":"X-Amz-Cf-Id","value":"VHK2xvb6F4HMJJc8bfel-OwPg9L8snhTf79N8NDQEQFV0cs_iCM27A=="}],"cookie":[],"responseTime":null,"body":"{}"},{"id":"9294cb64-9a55-4467-b329-97fbde421d8a","name":"Add Sensors Data - Wrong Api Key","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"sensors\":\r\n [\r\n {\r\n \"deviceId\": \"123ABC\",\r\n \"comms\": [\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"tc\",\r\n \"value\": 23\r\n },\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"co2\",\r\n \"value\": 650\r\n },\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"rh\",\r\n \"value\": 30\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://external-api.enerbrain.com/v2/sensors"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"387"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 28 Oct 2020 12:18:09 GMT"},{"key":"x-amzn-RequestId","value":"5fdba97b-422c-483a-9598-7aed612ed89d"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Origin, Content-Type, Authorization"},{"key":"x-amz-apigw-id","value":"VHwr-FuAjoEFV4w="},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, PATCH, OPTIONS"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5f99617f-152af8805a973f046996451a;Sampled=0"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"X-Cache","value":"Miss from cloudfront"},{"key":"Via","value":"1.1 af99c3a89a763b28315bf37a304c4f2c.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MXP64-C1"},{"key":"X-Amz-Cf-Id","value":"n9qM-imP69gDupIsfBgwmaHOuez42mOgZrH0Nr6MOLLtFNUmYvd9nQ=="}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Forbidden\"\n}"},{"id":"d4842b85-50e8-4ff3-879c-933a1d7d3ed6","name":"Add Sensors Data - Unauthorized","originalRequest":{"method":"POST","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"sensors\":\r\n [\r\n {\r\n \"deviceId\": \"123ABC\",\r\n \"comms\": [\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"tc\",\r\n \"value\": 23\r\n },\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"co2\",\r\n \"value\": 650\r\n },\r\n {\r\n \"timestamp\": 1603843202,\r\n \"type\": \"rh\",\r\n \"value\": 30\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://external-api.enerbrain.com/v2/sensors"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"41"},{"key":"Connection","value":"keep-alive"},{"key":"Date","value":"Wed, 28 Oct 2020 12:18:28 GMT"},{"key":"x-amzn-RequestId","value":"f31aa185-aae4-43d4-ad9b-25fa29f5774c"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Headers","value":"Origin, Content-Type, Authorization"},{"key":"x-amz-apigw-id","value":"VHwvPHKKDoEFt_g="},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, DELETE, PATCH, OPTIONS"},{"key":"X-Amzn-Trace-Id","value":"Root=1-5f996194-1d0fd03f432404e514de3a1b;Sampled=0"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"X-Cache","value":"Error from cloudfront"},{"key":"Via","value":"1.1 af99c3a89a763b28315bf37a304c4f2c.cloudfront.net (CloudFront)"},{"key":"X-Amz-Cf-Pop","value":"MXP64-C1"},{"key":"X-Amz-Cf-Id","value":"Qtl7QDul7teEFOsM8SJEJH1Q-6-zu4EpxQij2e4G_ERL1Um_JQEfFA=="}],"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized: You are not authorized to insert data.\"\n}"}],"_postman_id":"1b7d4fbe-5643-4868-acbb-f7b4c6d45ede"},{"name":"Get Buildings","id":"8f32b2be-1abf-4c87-bbb5-c4c3851be2ec","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://external-api.enerbrain.com/buildings","description":"

GET - Get Building List

\n

https://external-api.enerbrain.com/buildings

\n

Get Building List allows the user to extract the list of all buildings.

\n

An Enerbrain’s building object is stored using this formalism:

\n
{\n\"clientName\": String\n\"buildingId\": Integer\n\"buildingDescription\": String,\n\"timeZoneName\": String\n}\n
\n

Please note that the timeZoneName parameter refers to the standard time zone name as defined in the tz database (https://en.wikipedia.org/wiki/Tz_database and https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).

\n

The call to this function requires an authorization token passed via the x-api-key http header.

\n

Get Building List rate limits

\n

This API is intended as a mean to help the user to keep their local storage up to date. As such, a very low calling rate is assumed, i.e. less than one call per day. As the user is expected to keep a local storage for the buliding list and retrieve the building ID’s and data locally before calling Sensors or Consumption Data API’s, the use of Get Building API to get the building list at every Data request is strictly forbidden.

\n

Query String Parameters
None

\n

Example request:
https://external-api.enerbrain.com/buildings

\n

Example response:

\n
{\n\"clientName\": \"ClientNameExample\",\n\"buildingId\": 1,\n\"buildingDescription\": \"Building A\",\n\"timeZoneName\": \"Europe/Rome”\n},\n{\n\"clientName\": \"ClientNameExample\",\n\"buildingId\": 2,\n\"buildingDescription\": \"Building B\",\n\"timeZoneName\": \"America/Los_Angeles\"\n},\n{\n\"clientName\": \"ClientNameExample\",\n\"buildingId\": 3,\n\"buildingDescription\": \"Building C\",\n\"timeZoneName\": \"America/Los_Angeles\"\n}\n
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","name":"Enerbrain External APIs","type":"collection"}},"urlObject":{"protocol":"https","path":["buildings"],"host":["external-api","enerbrain","com"],"query":[],"variable":[]}},"response":[{"id":"8e393bb8-0ad4-4ee9-ae26-e77a2e2ddd0d","name":"Get Buildings - Success","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":"https://external-api.enerbrain.com/buildings"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"clientName\": \"ClientNameExample1\",\n \"buildingId\": 1,\n \"buildingDescription\": \"desc1\",\n \"timeZoneName\": \"Europe/Rome\"\n },\n {\n \"clientName\": \"ClientNameExample1\",\n \"buildingId\": 2,\n \"buildingDescription\": \"desc2\",\n \"timeZoneName\": \"Europe/Rome\"\n },\n {\n \"clientName\": \"ClientNameExample1\",\n \"buildingId\": 3,\n \"buildingDescription\": \"desc3\",\n \"timeZoneName\": \"Europe/Rome\"\n }\n]"},{"id":"0e118c40-be95-4759-aa1b-30e89f8ef37d","name":"Get Buildings - Wrong Api Key","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"gnihtemos","type":"text"}],"url":"https://external-api.enerbrain.com/buildings"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"You have an invalid Api Key {x_api_key}.\"\n}"},{"id":"60ba102d-c7c3-4710-ba61-aa8d0ee7f037","name":"Get Buildings - No Api Key","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"","type":"text"}],"url":"https://external-api.enerbrain.com/buildings"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Please add the Api Key into the Request.\"\n}"}],"_postman_id":"8f32b2be-1abf-4c87-bbb5-c4c3851be2ec"},{"name":"Get Consumption Data","id":"6b1ece32-a5cd-4007-be71-061fab688283","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://external-api.enerbrain.com/consumption","description":"

Get Consumption Data allows the user to extract last update / historical data.

\n

An Enerbrain's consumption object is stored using this formalism:

\n
{\n   \"registerId\": Integer,\n   \"registerDesc\": String,\n   \"timestamp\": Integer (Unix Timestamp),\n   \"value\": Float,\n   \"deviceId\": String,\n   \"registerType\": String { water|electricity|gas|heat }\n   \"unitMeasure\": String\n}\n\n
\n

The call to these functions requires an authorization header based on the x-api-key parameter.

\n

Number of communications of Consumption devices

\n

The number of communications of a Consumption Device is:

\n
    \n
  1. One communication every 60 minutes for COMX / EGX / Enless / Evvoss
    2. \n
  2. One communication every 15 minutes for the eMeter
    3. \n
  3. One communication every 5 minutes or 15 minutes or 60 minutes for the PLCs.
    4. \n
\n

The extraction of Last Update data can therefore be done in a range from 1 call every 5 minutes to 1 call per hour based on the Consumption devices in field.

\n

The Enerbrain Web Application consumption data (downloaded using the Download Measures feature) are hourly aggregated measures.

\n

Last Update

\n

Query String Parameters

\n

This is the list of arguments used to filter the extraction:

\n
    \n
  1. buildingId, mandatory parameter
    2. \n
  2. consumptionRegisterId, optional parameter
    3. \n
\n

Example

\n
https://external-api.enerbrain.com/consumption/last-update?buildingId={building_id}&consumptionRegisterId={consumption_register_id}\n\n

History (only 24 hours)

\n

Query String Parameters

\n

This is the list of arguments used to filter the extraction:

\n
    \n
  1. buildingId, mandatory parameter
    2. \n
  2. timestampStart, mandatory parameter
    3. \n
  3. timestampEnd, mandatory parameter
    4. \n
  4. consumptionRegisterId, optional parameter
    5. \n
\n

Business Logic

\n

This function limit the user to extract at most 24 hours of data, so the difference between timestampEnd - timestampStart must be <= 86400 (86400seconds = 24hours).

\n

Example

\n
https://external-api.enerbrain.com/consumption/history?buildingId={building_id}×tampStart={timestamp_start}×tampEnd={timestamp_end}&consumptionRegisterId={consumption_register_id}\n\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","name":"Enerbrain External APIs","type":"collection"}},"urlObject":{"protocol":"https","path":["consumption"],"host":["external-api","enerbrain","com"],"query":[],"variable":[]}},"response":[{"id":"c23812fd-2966-43cb-810d-35c24e280028","name":"Get Consumption History - Success","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/consumption/history?buildingId=987×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["consumption","history"],"query":[{"key":"buildingId","value":"987"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"registerId\": 321,\n \"registerDesc\": \"Foo\",\n \"timestamp\": 1618418418,\n \"value\": 54799.11328125,\n \"deviceId\": \"123ABC\",\n \"registerType\": \"electricity\",\n \"unitMeasure\": \"kWh\"\n },\n {\n \"registerId\": 654,\n \"registerDesc\": \"Bar\",\n \"timestamp\": 1618417800,\n \"value\": 851539.329523055,\n \"deviceId\": \"456DEF\",\n \"registerType\": \"electricity\",\n \"unitMeasure\": \"kWh\"\n }\n]"},{"id":"5032024c-34bc-4bc5-84a3-dd9cdd353275","name":"Get Consumption History - Wrong Api Key","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"gnihtemos","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/consumption/history?buildingId=987×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["consumption","history"],"query":[{"key":"buildingId","value":"987"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Forbidden\"\n}"},{"id":"a560f24e-07f5-41a7-8d0b-818c08025eae","name":"Get Consumption History - Wrong Building Identifier","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/consumption/history?buildingId=1×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["consumption","history"],"query":[{"key":"buildingId","value":"1"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized: You are not authorized to extract data from building 1.\"\n}"},{"id":"92c38381-8294-45a0-96e3-f8b04aab4c7e","name":"Get Consumption Last Update - Success","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/consumption/last-update?buildingId=987","protocol":"https","host":["external-api","enerbrain","com"],"path":["consumption","last-update"],"query":[{"key":"buildingId","value":"987"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"registerId\": 321,\n \"registerDesc\": \"Foo\",\n \"timestamp\": 1618418418,\n \"value\": 54799.11328125,\n \"deviceId\": \"123ABC\",\n \"registerType\": \"electricity\",\n \"unitMeasure\": \"kWh\"\n },\n {\n \"registerId\": 654,\n \"registerDesc\": \"Bar\",\n \"timestamp\": 1618417800,\n \"value\": 851539.329523055,\n \"deviceId\": \"456DEF\",\n \"registerType\": \"electricity\",\n \"unitMeasure\": \"kWh\"\n }\n]"},{"id":"cf5e12d4-938b-45cd-a7d7-952bbe83988b","name":"Get Consumption Last Update - Wrong Api Key","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"gnihtemos","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/consumption/last-update?buildingId=987","protocol":"https","host":["external-api","enerbrain","com"],"path":["consumption","last-update"],"query":[{"key":"buildingId","value":"987"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Forbidden\"\n}"},{"id":"b97059e1-9334-47cc-b4d4-cbb73be7d695","name":"Get Consumption Last Update - Wrong Building Identifier","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/consumption/last-update?buildingId=1","protocol":"https","host":["external-api","enerbrain","com"],"path":["consumption","last-update"],"query":[{"key":"buildingId","value":"1"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized: You are not authorized to extract data from building 1.\"\n}"}],"_postman_id":"6b1ece32-a5cd-4007-be71-061fab688283"},{"name":"Get Sensors Data","id":"3d31df67-7538-4161-b825-8de0ba99f968","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://external-api.enerbrain.com/sensors","description":"

Get Sensors Data allows the user to extract last update / historical data.

\n

An Enerbrain's sensor object is stored using this formalism:

\n
{\n   \"sensorId\": String,\n   \"sensorSerialNumber\": String,\n   \"type\": String { temperature|relative humidity|carbon dioxide|probes/pipe temperature },\n   \"value\": Float,\n   \"timestamp\": Integer (Unix Timestamp),\n   \"areaCode\": String,\n   \"unitMeasure\": String\n}\n
\n

The call to these functions requires an authorization header based on the x-api-key parameter.

\n

Number of communications of Sensors devices

\n

The number of communications of a Sensor Device is:

\n
    \n
  1. Minimum one communication every hour for eSenses
    2. \n
  2. One communication every 5 minutes or 15 minutes or 60 minutes for the PLCs.
    3. \n
\n

The extraction of Last Update data can therefore be done in a range from 1 call every 5 minutes to 1 call per hour based on the Consumption devices in field.

\n

Last Update

\n

Query String Parameters\n
\nThis is the list of arguments used to filter the extraction:

\n
    \n
  1. buildingId, mandatory parameter
    2. \n
  2. areaCode, optional parameter
    3. \n
  3. sensorId, optional parameter
    4. \n
\n

Example\n

\n
https://external-api.enerbrain.com/sensors/last-update?buildingId={building_id}&areaCode={area_code}&sensorId={sensor_id}\n

History (only 24 hours)

\n

Query String Parameters\n
\nThis is the list of arguments used to filter the extraction:

\n
    \n
  1. buildingId, mandatory parameter
    2. \n
  2. timestampStart, mandatory parameter
    3. \n
  3. timestampEnd, mandatory parameter
    4. \n
  4. areaCode, optional parameter
    5. \n
  5. sensorId, optional parameter
    6. \n
\n

Business Logic\n
\nThis function limit the user to extract at most 24 hours of data, so the difference between timestampEnd - timestampStart must be <= 86400 (86400seconds = 24hours).

\n

Example\n

\n
https://external-api.enerbrain.com/sensors/history?buildingId={building_id}&timestampStart={timestamp_start}&timestampEnd={timestamp_end}&areaCode={area_code}&sensorId={sensor_id}\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","name":"Enerbrain External APIs","type":"collection"}},"urlObject":{"protocol":"https","path":["sensors"],"host":["external-api","enerbrain","com"],"query":[],"variable":[]}},"response":[{"id":"4daba309-684d-4b2b-b1ac-11d7e71ee532","name":"Get Sensors History - Success","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/sensors/history?buildingId=987×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["sensors","history"],"query":[{"key":"buildingId","value":"987"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"sensorId\": \"QWE123\",\n \"sensorSerialNumber\": \"ESE000000123L001\",\n \"type\": \"temperature\",\n \"value\": 19.3,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"C°\"\n },\n {\n \"sensorId\": \"QWE123\",\n \"sensorSerialNumber\": \"ESE000000123L001\",\n \"type\": \"relative humidity\",\n \"value\": 45.0,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"%\"\n },\n {\n \"sensorId\": \"QWE123\",\n \"sensorSerialNumber\": \"ESE000000123L001\",\n \"type\": \"carbon dioxide\",\n \"value\": 45.0,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"ppm\"\n },\n {\n \"sensorId\": \"RTY456\",\n \"sensorSerialNumber\": \"ESE000000456L001\",\n \"type\": \"temperature\",\n \"value\": 20.2,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"C°\"\n },\n {\n \"sensorId\": \"RTY456\",\n \"sensorSerialNumber\": \"ESE000000456L001\",\n \"type\": \"relative humidity\",\n \"value\": 44.0,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"%\"\n }\n]"},{"id":"57570dc7-69d6-488e-bdfb-ee748416149b","name":"Get Sensors History - Wrong Api Key","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"gnihtemos","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/sensors/history?buildingId=987×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["sensors","history"],"query":[{"key":"buildingId","value":"987"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Forbidden\"\n}"},{"id":"5e1f0b49-3f13-4462-99f2-11cce7d49e6f","name":"Get Sensors History - Wrong Building Identifier","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/sensors/history?buildingId=1×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["sensors","history"],"query":[{"key":"buildingId","value":"1"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized: You are not authorized to extract data from building 1.\"\n}"},{"id":"d0452c89-d78c-4eb4-8cb3-148a3271ba00","name":"Get Sensors Last Update - Success","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/sensors/last-update?buildingId=987","protocol":"https","host":["external-api","enerbrain","com"],"path":["sensors","last-update"],"query":[{"key":"buildingId","value":"987"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"sensorId\": \"QWE123\",\n \"sensorSerialNumber\": \"ESE000000123L001\",\n \"type\": \"temperature\",\n \"value\": 19.3,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"C°\"\n },\n {\n \"sensorId\": \"QWE123\",\n \"sensorSerialNumber\": \"ESE000000123L001\",\n \"type\": \"relative humidity\",\n \"value\": 45.0,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"%\"\n },\n {\n \"sensorId\": \"QWE123\",\n \"sensorSerialNumber\": \"ESE000000123L001\",\n \"type\": \"carbon dioxide\",\n \"value\": 45.0,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"ppm\"\n },\n {\n \"sensorId\": \"RTY456\",\n \"sensorSerialNumber\": \"ESE000000456L001\",\n \"type\": \"temperature\",\n \"value\": 20.2,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"C°\"\n },\n {\n \"sensorId\": \"RTY456\",\n \"sensorSerialNumber\": \"ESE000000456L001\",\n \"type\": \"relative humidity\",\n \"value\": 44.0,\n \"timestamp\": 1618358635,\n \"areaCode\": \"A001\",\n \"unitMeasure\": \"%\"\n }\n]"},{"id":"8dd1e223-44d9-4a00-9d35-80fbff3fbd15","name":"Get Sensors Last Update - Wrong Api Key","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"gnihtemos","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/sensors/last-update?buildingId=987","protocol":"https","host":["external-api","enerbrain","com"],"path":["sensors","last-update"],"query":[{"key":"buildingId","value":"987"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Forbidden\"\n}"},{"id":"7cb2995c-c24a-4e8d-9e01-0ae09dbd4466","name":"Get Sensors Last Update - Wrong Building Identifier","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/sensors/last-update?buildingId=1","protocol":"https","host":["external-api","enerbrain","com"],"path":["sensors","last-update"],"query":[{"key":"buildingId","value":"1"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized: You are not authorized to extract data from building 1.\"\n}"}],"_postman_id":"3d31df67-7538-4161-b825-8de0ba99f968"},{"name":"Get External Data","id":"68810721-3d1a-4407-b535-7f5727cdd52c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://external-api.enerbrain.com/external-data","description":"

Get External Data Data allows the user to extract last update / historical data.

\n

An Enerbrain's external data object is stored using this formalism:

\n
{\n   \"buildingId\": Integer,\n   \"temperature\": Float,\n   \"unitMeasureTemperature\": String,\n   \"humidity\": Float,\n   \"unitMeasureHumidity\": String,\n   \"cloudy\": String,\n   \"dayTempMax\": Float,\n   \"dayTempMin\": Float,\n   \"dayAvgHum\": Float,\n   \"timestamp\": Integer\n}\n
\n

The call to these functions requires an authorization header based on the x-api-key parameter.

\n

Number of communications of Sensors devices

\n

The number of communications of our External Data is one communication each hour.

\n

Last Update

\n

Query String Parameters\n
\nThis is the list of arguments used to filter the extraction:

\n
    \n
  1. buildingId, mandatory parameter
    2. \n
\n

Example\n

\n
https://external-api.enerbrain.com/external-data/last-update?buildingId={building_id}\n

History (only 24 hours)

\n

Query String Parameters\n
\nThis is the list of arguments used to filter the extraction:

\n
    \n
  1. buildingId, mandatory parameter
    2. \n
\n

Business Logic\n
\nThis function limit the user to extract at most 24 hours of data, so the difference between timestampEnd - timestampStart must be <= 86400 (86400seconds = 24hours).

\n

Example\n

\n
https://external-api.enerbrain.com/external-data/history?buildingId={building_id}\n
","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","id":"2f7862cd-4c93-4c09-96b8-e7b1ce405180","name":"Enerbrain External APIs","type":"collection"}},"urlObject":{"protocol":"https","path":["external-data"],"host":["external-api","enerbrain","com"],"query":[],"variable":[]}},"response":[{"id":"4b6db1e7-0f59-498a-a098-c36e1b6b75aa","name":"Get External Data History - Success","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/external-data/history?buildingId=987×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["external-data","history"],"query":[{"key":"buildingId","value":"987"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"[\n {\n \"buildingId\": 987,\n \"temperature\": 3.61,\n \"unitMeasureTemperature\": \"C°\",\n \"humidity\": 83,\n \"unitMeasureHumidity\": \"%\",\n \"cloudy\": \"4.0\",\n \"dayTempMax\": 14.54,\n \"dayTempMin\": 2.44,\n \"dayAvgHum\": 70,\n \"timestamp\": 1618359002\n }\n]"},{"id":"dca83dac-6080-4002-9f2a-3054eae1c9b6","name":"Get External Data History - Wrong Api Key","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"gnihtemos","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/external-data/history?buildingId=987×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["external-data","history"],"query":[{"key":"buildingId","value":"987"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Forbidden\"\n}"},{"id":"f6b96706-67e4-466a-af71-c98f980727b8","name":"Get External Data History - Wrong Building Identifier","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/external-data/history?buildingId=1×tampStart=1618358400×tampEnd=1618409655","protocol":"https","host":["external-api","enerbrain","com"],"path":["external-data","history"],"query":[{"key":"buildingId","value":"1"},{"key":"timestampStart","value":"1618358400"},{"key":"timestampEnd","value":"1618409655"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized: You are not authorized to extract data from building 1.\"\n}"},{"id":"9b43bcb7-52a0-45eb-b69c-e0ff21d948d3","name":"Get External Data Last Update - Success","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/external-data/last-update?buildingId=987","protocol":"https","host":["external-api","enerbrain","com"],"path":["external-data","last-update"],"query":[{"key":"buildingId","value":"987"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"[\n {\n \"buildingId\": 987,\n \"temperature\": 3.61,\n \"unitMeasureTemperature\": \"C°\",\n \"humidity\": 83,\n \"unitMeasureHumidity\": \"%\",\n \"cloudy\": \"4.0\",\n \"dayTempMax\": 14.54,\n \"dayTempMin\": 2.44,\n \"dayAvgHum\": 70,\n \"timestamp\": 1618359002\n }\n]"},{"id":"bbaeff5f-3318-4e79-a4ca-7858d10ed290","name":"Get External Data Last Update - Wrong Api Key","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"gnihtemos","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/external-data/last-update?buildingId=987","protocol":"https","host":["external-api","enerbrain","com"],"path":["external-data","last-update"],"query":[{"key":"buildingId","value":"987"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Forbidden\"\n}"},{"id":"f028054c-0b83-462a-9124-1251afb51766","name":"Get External Data Last Update - Wrong Building Identifier","originalRequest":{"method":"GET","header":[{"key":"x-api-key","value":"something","type":"text"}],"url":{"raw":"https://external-api.enerbrain.com/external-data/last-update?buildingId=1","protocol":"https","host":["external-api","enerbrain","com"],"path":["external-data","last-update"],"query":[{"key":"buildingId","value":"1"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":null,"cookie":[],"responseTime":null,"body":"{\n \"message\": \"Unauthorized: You are not authorized to extract data from building 1.\"\n}"}],"_postman_id":"68810721-3d1a-4407-b535-7f5727cdd52c"}],"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"84c3005d-495d-49cd-b6ca-0bf71397642e","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"dba5fa8c-e12f-4237-b51b-11c900516954","type":"text/javascript","exec":[""]}}],"variable":[{"value":"","disabled":true}]}