The API user account will need to be created in the “Convirza for advertisers” (CFA) APP under Groups and Users. The username is the Email field. We recommend setting a strong Password. Both fields become the credentials for the API. This user will need to have a role of ADMIN. Only Admins will have access to use the API. The API user will have access to data from the Group the User was created in and below.
Enter the following details to get the API authentication token that should be used to access the API methods:
When you POST to the API method it will generate an access_token as part of the response. Please use the access_token in header as part of ALL subsequent CFA API method calls.
Sample: POST Request body (json) and Response output (json) for authenticating and retrieving the access_token:
Enter the following details to get a list of calls. (Refer to https://apicfa.convirza.com/apidoc for an available list of API methods):
Use a third party client, such as Postman or Advanced REST Client to test the Convirza API.
How to do GET Requests:
All GET requests can include 3 additional parameters that are attached to the request in the query string. This entire value string should be URL encoded.
Note that the following parameters are not required, but available to most of the method endpoints.
This is used to set the limit on the number of records returned (default: 100)
The number of records to skip before starting the return set (default: 0)
Definition of rules enforced on the record set to reduce the return set
The value for filter is a set of rules, each of which is comma separated.
Each rule must contain three parts to it,
Note that there are also a few special values that can be used for the value, which are:
All of the parameters are included in the query string, or in other words on the right side of the question mark, with each parameter separated with an ampersand in standard browser compliant formatting. The entire value string for the ‘filter’ parameter must be URL encoded or will not be valid and will fail.