Convertr Publisher API v2
1.0 Scope
This document contains the technical information required for accessing the RESTful API offered by Convertr. Currently the main goal of this API is to feedback live stats to our network and facilitate the delivery of new customer records.
It should be noted that all reporting information gathered from the use of this API are unconfirmed and should be used merely as an awareness tool while running a campaign with us.
2.0
This version of the API is accessible from the following url, at this point there is a single entry point for all requests.```https
| https://{enterprise}.cvtr.io/api/v2/ |
|---|
...
3.0 Usage & Examples
### 3.1 Prerequisites
All Publisher users by default have access to the Convertr Publisher API. Your access credentials are supplied with your campaign assets after you have been assined to a campaign, but are also available from the Convertr Dashboard.
### 3.2 Authentication Token
In order for you to query the API, all request must be sent with an authentication token.
This needs to be requested from the following url using a `GET` GET request. Once the token has been returned, it will expire after 60 minutes.
#### Request```
| GET https://{enterprise}.cvtr.io/oauth/v2/token?grant_type=https://convertr.cvtr.io/grants/api_key&client_id={CLIENT_ID}&client_secret={CLIENT_SECRET}&api_key={API_KEY} |
...
| Parameter |
|---|
...
| Required |
|---|
...
| Description |
|---|
...
| client_id | Yes | Client ID which is supplied on a platform wide bases |
...
| client_ |
...
| secret | Yes |
...
| Client Secret which is supplied on a platform wide bases |
...
| api_ |
...
| key | Yes |
...
| API Key that is unique to each user |
#### Response```
| { access_token: "ODM5NTIwNjk1MjdhNTMzMzk0MTY2Y2ZkYjg2OWFlN2Y5YzZlNTk1NmUwZmVjOGRkMDhhMzllYTA2ZTA0MDI3Zg" expires_in: 3600 token_type: "bearer" scope: null refresh_token: "YTQzODk3MDdiM2FhMGYzODYyOTcyOTBkYWZiZWI3YzJmNmEwYmJkYWJiM2I0NzU1Y2Q5OTcwZDA0YzhiZGNjYQ" } |
```### 3.3 Form Fields Endpoint
This API call will supply an array of forms which are available to `POST` leads to (see section 3.5) on a given campaign.
The response will allow you to see which form fields are available to populate per form (each campaign can have multiple forms).
#### Request```
| GET https://{enterprise}.cvtr.io/api/v2/publisher/fields/{CAMPAIGN_ID}?access_token={ACCESS_TOKEN} |
...
| Parameter |
|---|
...
| Required |
|---|
...
| Description | ||
|---|---|---|
| CAMPAIGN_ID | Yes | ID for the campaign you are wishing to see a list of available forms |
...
| ACCESS_ |
...
| TOKEN | Yes |
...
| Access token acquired in 3.2 |
#### Response
```
[
{
"fields": [
"form[firstName]",
"form[email]",
"form[lastName]",
"form[submit]"
],
"formId": 35,
"formName": "Acme Campaign - Simple Form"
},
{
"fields": [
"form[promotion]",
"form[title]",
"form[firstName]",
"form[lastName]",
"form[email]",
"form[lookup][addressLine1]",
"form[lookup][addressLine2]",
"form[lookup][addressLine3]",
"form[lookup][addressLine4]",
"form[lookup][postcode]",
"form[telephone][countryCode]",
"form[telephone][telephone]",
"form[submit]"
],
"formId": 23,
"formName": "Acme Campaign - Advanced Form"
}
]
```
...