After reading all the documentation, you might want to give Intelligence API a try. For that, we have prepared a demo environment that anyone can access. Authentication is required, but any token that you pass should work, so no need to get a User or Application key in advance.
To show how this environment works, we will use Postman, but you can use any other REST client.
The URL where this API can be located is: https://16abf815-424c-413e-b92d-6c6f8fc633cd.remockly.com/api. Keep in mind that
for real production environments, the URL typically ends with
/intelligence/api and not
Let's start this Tutorial by creating a new HTTP Request in Postman (File > New > HTTP Request). Make sure that you have selected a GET operation and paste the URL for the API next to it: https://16abf815-424c-413e-b92d-6c6f8fc633cd.remockly.com/api.
Let's say we have our User API Key which is
NASDYUmYxMjItNmJJHuNYSdn7FkLThhasdhj89jM2ODVmOio090sadjkdkVnRFV3VVBtZ1jksadb8olJWXMSDHUASDik3UE5j. Go to Postman
and use this key for the Authentication header.
Authorization and select
Bearer Token for the Type. For the token, paste the above key.
Now we should be ready to start getting some information such as the full list of Knowledge Models. For that,
you need to add '/knowledge-models' at the end of the URL. As we can see, there is one Knowledge Model with the id
open-purchase-requisition.purchase-requisition-km and named
Purchase Requisition KM. As we can tell by the name, this
Knowledge Model is giving us information about Purchases that happened in the company.
Next, let's see the details for the
Purchase Requisition KM Knowledge Model. In order to do that, we need to append the
id of the Knowledge Model to the URL we used for the previous step. In the results we can get extra information for this
Knowledge Model, for example that is extending another Knowledge Model with id
Now it's time to discover the available records for this Knowledge Model. These records will tell us
which kind of data we will be able to retrieve. Let's add
/records to the URL in the previous step. By looking at the
response, we can tell that we have one record called 'Materials' which contains the "materials that have been purchased".
Next, let's discover which filters the
Purchase Requisition KM Knowledge Model has available. We can do so by simply
/filters to the URL used in step #4. As we can see, we have one filter named '24 Months', which lets us get
the materials purchased in the last 24 months.
In order to see the fields that can be consumed in a record, simply append the id of the record in the URL we used in
step #5. Keep in mind that the URL is case-sensitive, so since the id is 'MATERIALS', we would need to append
In the response, we can see that there are 3 string fields for the 'Materials' record: Material Name, Material Number and
Finally, it's time to consume the data for the
Materials Record. For this we need to first append
/data to the URL we got
in step #7. Then, we should also specify the field ids that we want to retrieve. For this last step, add a Parameter
Params tab named
fields with the value
material_number, material_name, material_group. We get only one result:
a material named 'PC Installation / Configuration' with the number 'I-1000' and group 'Services'.
Keep in mind that this is just a simple demo. Features like Filter, Filter Expressions and many others are not supported. However, we expect you now have a better understanding of how to use Intelligence API. If you want to become more familiar with the API, we recommend you to have a look at our Tutorials.