API Documentation

Swagger is an open source software framework backed by a large ecosystem of tools that helps developers design, build, document, and consume RESTful Web services. All Percipio REST APIs are documented using OpenAPI and provide the ability to call the functions via a UI called the Swagger UI (https://swagger.io/tools/swagger-ui/).

Example of using the Swagger UI to call a Percipio API

  1. Open the Content Discovery Swagger page: https://api.percipio.com/content-discovery/api-docs/

  2. Click Authorize.

    3. Content discovery service page

  3. Paste the Skillsoft supplied bearer token into value field and click Authorize.

    Authorization value field

  4. Once the service account authorization is confirmed, click Close.

  5. Click GET for the collections function.
  6. Collections function with a GET button next to it
  7. Click Try it Out, this will enable the text box to enter the PercipioOrganization ID.
    8. Note: Contact your Skillsoft Account team to obtain a Percipio Organization ID.
  8. Organization ID entered into the parameters tab
  9. Click Execute.
  10. The request will be submitted, and an example of how to make the same call using cURL will be shown along with the response:
  11. Responses page. Fields for curl and request URL
  12. An example response for a valid organization is shown below:
  13. Response body and response header fields for a valid organization