A Resource Key grants your code access to the 51Degrees Cloud APIs. A specific Resource Key has access to a particular set of properties which are chosen at key creation time and cannot be changed afterwards. The number of accesses authorized by a particular Resource Key is limited for free keys, or can be associated with your License Key and thus your account.
To obtain a Resource Key, use the Cloud Configurator; instructions on how to use the Cloud Configurator to create a key while associating it with properties and your License Key are part of the Configurator explanation, which describes the process in detail.
Authorization errors
If you attempt to retrieve API values for which your Resource Key is not authorized, you may see errors similar to these:
Property "country" not found in data for element "location". This is because your resource key does not include access to any properties under "location".
Property "state" not found in data for element "location". This is because your resource key does not include access to this property. Properties that are included for this key under "location" are javascript, town, country.
As mentioned, all properties that a key is authorized to access must be chosen at key creation time. If you create a key with access to the javascript, town, and country properties under location, for example, and then try to access the state property of a geolocation retrieved from the cloud APIs, you will see the second error, above. (If the key in question has access to no properties under location, you may see the first error instead.)
A Resource Key cannot have its list of properties changed, but you can follow the Configurator explanation to create a new different Resource Key which does have access to the properties you need.
Failed to load aspect properties
When using the on-Premise APIs, if you attempt to create a cloud pipeline with properties for which your Resource Key is not authorized, you may see errors similar to these:
- Your resource key does not include access to any properties under the engine with key hardware that was added to the pipeline. For more details on resource keys, see our explainer: https://51degrees.com/documentation/_info__resource_keys.html Available engine data keys are: ['device']
- Failed to load aspect properties for element 'hardware'. This is because your resource key does not include access to any properties under 'hardware'. For more details on resource keys, see our explainer: https://51degrees.com/documentation/_info__resource_keys.html
This occurs when creating a Cloud Engine or Element and the Resource Key you provided is not authorized to access any properties associated with the Engine.
First, check that you have selected properties that are supported by the Engine. The Cloud Service can be queried for all the available properties. In the JSON response, the Id of each property is prefixed with the Engine or Element data key, the relevant key is shown in the error above. This will show you what property names can be selected. Next, check the existing properties in your Resource Key. If you find that the required properties are missing from your configuration then you will need to select them and create a new Resource Key.
A Resource Key cannot have its list of properties changed, but you can follow the Configurator explanation to create a new different Resource Key which does have access to the properties you need.
Second, if the above does not solve the issue then make sure that you are authorized to use the properties selected when creating the Resource Key. To do this, browse to Cloud service using your Resource Key: https://cloud.51degrees.com/api/v4/<resource_key>.json (delete < and > when providing your Resource Key). You will see a response containing values for your configure properties like the following:
If you see any null reasons like priceband is a paid feature. You need a licence key to retrieve data. Visit https://51degrees.com/pricing for details then you do not have the required subscription to access the property. You can check the 51Degrees Property Dictionary to see what subscription is required.
Seeing existing key authorized properties
Some of the error message above will list the properties for which the used key is authorized, but you can also see the properties for a key you already have by constructing and visiting the URL https://configure.51degrees.com/YOUR_RESOURCE_KEY. This will show Step 1 of the Configurator with the properties for this specific key already selected.
Beware: continuing to steps 2 or 3 will not edit the properties attached to your Resource Key, since Resource Keys are immutable; instead, it will create a new Resource Key.