FacilitiesApi v1.0.0
Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.
Base URLs:
Email: Iberinform Web: Iberinform
Authentication
-
API Key (ClientSecretHeader)
- Parameter Name: X-IBM-Client-Secret, in: header. Unique token directly related to the client contract
-
API Key (APIKeyHeader)
- Parameter Name: X-IBM-Client-Id, in: header.
Default
get__facilities_{organisationID}
Code samples
URL obj = new URL("https://$(catalog.host)/modules/facilities/{organisationID}");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("GET");
int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
in.close();
System.out.println(response.toString());
const headers = {
'Accept':'application/json',
'X-IBM-Client-Id':'API_KEY',
'X-IBM-Client-Secret':'API_KEY'
};
fetch('https://$(catalog.host)/modules/facilities/{organisationID}',
{
method: 'GET',
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
GET https://$(catalog.host)/modules/facilities/{organisationID} HTTP/1.1
Accept: application/json
'application/json',
'X-IBM-Client-Id' => 'API_KEY',
'X-IBM-Client-Secret' => 'API_KEY',
);
$client = new \GuzzleHttp\Client();
// Define array of request body.
$request_body = array();
try {
$response = $client->request('GET','https://$(catalog.host)/modules/facilities/{organisationID}', array(
'headers' => $headers,
'json' => $request_body,
)
);
print_r($response->getBody()->getContents());
}
catch (\GuzzleHttp\Exception\BadResponseException $e) {
// handle exception or api errors.
print_r($e->getMessage());
}
// ...
import requests
headers = {
'Accept': 'application/json',
'X-IBM-Client-Id': 'API_KEY',
'X-IBM-Client-Secret': 'API_KEY'
}
r = requests.get('https://$(catalog.host)/modules/facilities/{organisationID}', headers = headers)
print(r.json())
require 'rest-client'
require 'json'
headers = {
'Accept' => 'application/json',
'X-IBM-Client-Id' => 'API_KEY',
'X-IBM-Client-Secret' => 'API_KEY'
}
result = RestClient.get 'https://$(catalog.host)/modules/facilities/{organisationID}',
params: {
}, headers: headers
p JSON.parse(result)
# You can also use wget
curl -X GET https://$(catalog.host)/modules/facilities/{organisationID} \
-H 'Accept: application/json' \
-H 'X-IBM-Client-Id: API_KEY' \
-H 'X-IBM-Client-Secret: API_KEY'
GET /facilities/{organisationID}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
organisationID | path | string | true | identificador de la firma |
language | query | string | false | Idioma generación |
Example responses
200 Response
"{"facilitiesNumber":0,"mainFacility":{"address":{"country":{"code":"string","value":"string"},"dateUntil":"2019-10-02T10:30:43.011Z","fullAddress":"string","number":"string","otherDetails":"string","postcode":"string","province":{"code":"string","value":"string"},"streetName":"string","streetType":{"code":"string","value":"string"},"town":{"code":"string","value":"string"},"urbanArea":"string"},"addressStatus":"string","areaType":{"code":"string","value":"string"},"commercialTitle":"string","descriptions":[{"code":"string","value":"string"}],"expectedRefurbishmentImprovement":"string","expectedRenewalImprovement":"string","geolocation":{"latitude":0,"longitude":0},"incidents":{"code":"string","incidentDetails":[{"dateFrom":"string","dateTo":"string","impact":"string","type":"string"}],"unavailabilityReason":"string"},"investigatedFacility":"string","location":{"code":"string","value":"string"},"machineryLife":"string","ownership":"string","photograph":"string","proficiencyLevel":"string","situation":{"code":"string","value":"string"},"squareMeters":"string","telephone":"string","use":"string"},"notAvailable":"string","otherFacilities":[{"address":{"country":{"code":"string","value":"string"},"dateUntil":"2019-10-02T10:30:43.011Z","fullAddress":"string","number":"string","otherDetails":"string","postcode":"string","province":{"code":"string","value":"string"},"streetName":"string","streetType":{"code":"string","value":"string"},"town":{"code":"string","value":"string"},"urbanArea":"string"},"addressStatus":"string","areaType":{"code":"string","value":"string"},"commercialTitle":"string","descriptions":[{"code":"string","value":"string"}],"expectedRefurbishmentImprovement":"string","expectedRenewalImprovement":"string","geolocation":{"latitude":0,"longitude":0},"incidents":{"code":"string","incidentDetails":[{"dateFrom":"string","dateTo":"string","impact":"string","type":"string"}],"unavailabilityReason":"string"},"investigatedFacility":"string","location":{"code":"string","value":"string"},"machineryLife":"string","ownership":"string","photograph":"string","proficiencyLevel":"string","situation":{"code":"string","value":"string"},"squareMeters":"string","telephone":"string","use":"string"}]}"
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | 200 OK | FaciliDetail |
401 | Unauthorized | Unauthorized | ErrorDetail |
403 | Forbidden | Forbidden | ErrorDetail |
404 | Not Found | Recurso no encontrado | ErrorDetail |
500 | Internal Server Error | Internal error | ErrorDetail |
Schemas
ErrorDetail
"{"code":"string","message":"string","principal":"string","status":0}"
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
code | string | false | none | none |
message | string | false | none | none |
principal | string | false | none | none |
status | number | false | none | none |
FaciliDetail
"{"facilitiesNumber":0,"mainFacility":{"address":{"country":{"code":"string","value":"string"},"dateUntil":"2019-10-02T10:30:43.011Z","fullAddress":"string","number":"string","otherDetails":"string","postcode":"string","province":{"code":"string","value":"string"},"streetName":"string","streetType":{"code":"string","value":"string"},"town":{"code":"string","value":"string"},"urbanArea":"string"},"addressStatus":"string","areaType":{"code":"string","value":"string"},"commercialTitle":"string","descriptions":[{"code":"string","value":"string"}],"expectedRefurbishmentImprovement":"string","expectedRenewalImprovement":"string","geolocation":{"latitude":0,"longitude":0},"incidents":{"code":"string","incidentDetails":[{"dateFrom":"string","dateTo":"string","impact":"string","type":"string"}],"unavailabilityReason":"string"},"investigatedFacility":"string","location":{"code":"string","value":"string"},"machineryLife":"string","ownership":"string","photograph":"string","proficiencyLevel":"string","situation":{"code":"string","value":"string"},"squareMeters":"string","telephone":"string","use":"string"},"notAvailable":"string","otherFacilities":[{"address":{"country":{"code":"string","value":"string"},"dateUntil":"2019-10-02T10:30:43.011Z","fullAddress":"string","number":"string","otherDetails":"string","postcode":"string","province":{"code":"string","value":"string"},"streetName":"string","streetType":{"code":"string","value":"string"},"town":{"code":"string","value":"string"},"urbanArea":"string"},"addressStatus":"string","areaType":{"code":"string","value":"string"},"commercialTitle":"string","descriptions":[{"code":"string","value":"string"}],"expectedRefurbishmentImprovement":"string","expectedRenewalImprovement":"string","geolocation":{"latitude":0,"longitude":0},"incidents":{"code":"string","incidentDetails":[{"dateFrom":"string","dateTo":"string","impact":"string","type":"string"}],"unavailabilityReason":"string"},"investigatedFacility":"string","location":{"code":"string","value":"string"},"machineryLife":"string","ownership":"string","photograph":"string","proficiencyLevel":"string","situation":{"code":"string","value":"string"},"squareMeters":"string","telephone":"string","use":"string"}]}"
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
facilitiesNumber | number | false | none | none |
mainFacility | object | false | none | none |
address | object | false | none | none |
country | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
dateUntil | string | false | none | none |
fullAddress | string | false | none | none |
number | string | false | none | none |
otherDetails | string | false | none | none |
postcode | string | false | none | none |
province | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
streetName | string | false | none | none |
streetType | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
town | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
urbanArea | string | false | none | none |
addressStatus | string | false | none | none |
areaType | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
commercialTitle | string | false | none | none |
descriptions | [object] | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
expectedRefurbishmentImprovement | string | false | none | none |
expectedRenewalImprovement | string | false | none | none |
geolocation | object | false | none | none |
latitude | number | false | none | none |
longitude | number | false | none | none |
incidents | object | false | none | none |
code | string | false | none | none |
incidentDetails | [object] | false | none | none |
dateFrom | string | false | none | none |
dateTo | string | false | none | none |
impact | string | false | none | none |
type | string | false | none | none |
unavailabilityReason | string | false | none | none |
investigatedFacility | string | false | none | none |
location | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
machineryLife | string | false | none | none |
ownership | string | false | none | none |
photograph | string | false | none | none |
proficiencyLevel | string | false | none | none |
situation | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
squareMeters | string | false | none | none |
telephone | string | false | none | none |
use | string | false | none | none |
notAvailable | string | false | none | none |
otherFacilities | [object] | false | none | none |
address | object | false | none | none |
country | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
dateUntil | string | false | none | none |
fullAddress | string | false | none | none |
number | string | false | none | none |
otherDetails | string | false | none | none |
postcode | string | false | none | none |
province | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
streetName | string | false | none | none |
streetType | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
town | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
urbanArea | string | false | none | none |
addressStatus | string | false | none | none |
areaType | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
commercialTitle | string | false | none | none |
descriptions | [object] | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
expectedRefurbishmentImprovement | string | false | none | none |
expectedRenewalImprovement | string | false | none | none |
geolocation | object | false | none | none |
latitude | number | false | none | none |
longitude | number | false | none | none |
incidents | object | false | none | none |
code | string | false | none | none |
incidentDetails | [object] | false | none | none |
dateFrom | string | false | none | none |
dateTo | string | false | none | none |
impact | string | false | none | none |
type | string | false | none | none |
unavailabilityReason | string | false | none | none |
investigatedFacility | string | false | none | none |
location | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
machineryLife | string | false | none | none |
ownership | string | false | none | none |
photograph | string | false | none | none |
proficiencyLevel | string | false | none | none |
situation | object | false | none | none |
code | string | false | none | none |
value | string | false | none | none |
squareMeters | string | false | none | none |
telephone | string | false | none | none |
use | string | false | none | none |