Getting started with the IGLOO API

The IGLOO API provides developers with the means to create and modify objects within a digital workplace programmatically.

Igloo provides two versions of APIs. Although they both return the same data with a little twist to the response objects, there are some advantages to using one over the other. To learn more about v1 and v2, we've briefly covered in our authentication article.

Below is how you can identify v1 over v2:

• API v1 is prefixed with: /.api/api.svc/ ...
  
• API v2 is prefixed with: /.api2/api / ...
  

Click here to view a complete list of our APIs. *NOTE*: You must be logged into customer care to access our swagger documentation.

Object IDs.

Almost every object in a digital workplace has a unique Object ID and is a requirement if you want to query data from that object or modify it in anyway.
There are two methods for finding an Objects ID.

1. Inspect the DOM
2. Using the API

To learn more about how to get Object IDs from objects in IGLOO. In this article we've covered how to us the API to get data around the object by using the path to that object.

API Call prerequisites

API calls require that a user authenticates before they can do anything within a digital workplace. To authenticate you will need:

1. An API key
2. API password
3. A locally (not managed externally) created user
4. And a valid digital workpalce

Once you have the above four you can proceed with creating a session to your digital workplace and use the API. To learn more about what you need to get started and how to create a session, we spoke about it in detail in this article.

Where to get help

Visit our developer site to find out more about the IGLOO API and widget development and to get access to the IGLOO API Documentation. You can also contact devsupport@igloosoftware.com if you have any questions around how the API works or if you have a really cool idea but don't know where to get started! Our Developer Advocates are here to help.