13 Accessing REST Services V1 and V2

The following types of authentications are supported for REST APIs (V1 and V2):

  • Basic authentication
  • OAuth authentication

Depending on the authentication, a token is generated using an endpoint URL.

New integration users are configured to use Basic authentication by default.

If your integration user requires OAuth authentication (supported only in cloud environments), you must configure the user through Primavera Administration and submit a Service Request (SR). For more information, see the Primavera Administration Identity Management Configuration Guide.

This section describes how to obtain a token to authenticate yourself for using REST services.

For Basic authentication, see Setting Up Integration Users with Basic Authentication.

For OAuth authentication, see Setting Up Integration Users with OAuth Authentication.

Note:

If the endpoint URL has a project number that contains special characters such as / \ : * ? " < > or |, you must change those special characters to URL escape characters. For example, a project number with a special number sign (hash) such as 2020#7 must be changed to 2020%7. You can use a browser to access the list of URL escape characters.