PingAccess ships with interactive documentation for both developers and non-developers to explore the PingAccess API endpoints, view a reference of the metadata for each API, and experiment with API calls.
PingAccess APIs are REST APIs that provide complete administrative capabilities of the product. They can be called from custom applications or from command line tools, such as cURL.
These endpoints are only available on the admin.port
defined in the
/pa-admin-api/v3/api-docs/<PA_HOME>/conf/run.properties
file, for example,
https://<PA_HOME>:<PORT>/pa-admin-api/v3/api-docs/
.
If you selected the Use context root as reserved resource base
path check box on your PingAccess application, this feature creates an
instance of any reserved PingAccess
resources under the application’s context root. As such, the context root of the
application needs to prepend the reserved context application root
(/pa
by default) in any file paths that reference it. If
the context root of your application is myApp
, the file path
would start with /myApp/pa
.
For enhanced API security, you must include X-XSRF-Header:
PingAccess
in all requests and use the
application/json
content type for PUT/POST requests.