How to Make API Requests
You can use and combine different HTTP methods to make REST API requests to APSIS One's APIs.
You can use GET, POST, PUT, PATCH and DELETE verbs with the URL to the API resource or service to submit data, update or delete a resource.
The base URI to the API service and its resources is only available over the HTTPS protocol.
Per region host names
APSIS One API is provided under different hostnames depending on your region. For EU use https://api.apsis.one/ and for APAC call https://api-apac.apsis.one/.
All resources and sub-resources are defined by the API service that they represent, formatted as
resource/{discriminator}
Here is a sample request to list all the Sections from an APSIS One account, followed by requesting a specific section.
curl -X GET "https://api.apsis.one/audience/sections" \
-H "accept: application/json" \
-H "authorization: Bearer "
curl -X GET "https://api.apsis.one/audience/sections/{section_discriminator}/tags" \
-H "accept: application/json" \
-H "authorization: Bearer "
It's important to know that you must have valid JSON in your request body to do successful API calls. To read more about valid JSON requests, visit this page.
For example, Boolean values must be lowercase.
{
"type": true
}
HTTP Request Headers
The accepted and most commonly used HTTP request headers are the following.
Accept
Most operations will include a response body. The response format must be set to JSON in the following syntax format.
Accept: application/json
Authorization
Required to make REST API calls to resources.
The access token must be included in the Authorization header with the Bearer authentication scheme, in the following syntax format.
Authorization: Bearer
Content-Type
For operations that require a request body, the content type must be set to JSON in the following syntax format.
Content-Type: application/json