Просмотреть исходный

Entities

Common API supports the following top-level entities (some entities are optional and should be used only in case your solution does support them).

ID	Description
`advertisers`	Advertisers
`campaigns`	Campaigns
`campaign_groups`	Campaign groups sharing common budget
`creatives`	Creatives
`sites`	Sites
`segment_definitions`	Common segments
`reference_tables`	Contains additional information and various settings
`domains_lists`	Common domain lists
`snippets`	Common snippets

Methods

Method	Description
`all`	Get all entities
`list`	List entities
`get`	Get specific entity info
`new`	Create a new entity
`edit`	Update specific entity
`delete`	Delete specific entity

Variables

All API methods use the following required variables. Pagination and output control options are also available.

Variable	Description
<entity>	Object type (reference_tables, segment_definitions, ...)
<entity_id>	Object's ID
<token>	Token for API access. This value can be found in "My settings" user's menu.

Examples

Get all entities

GET https://ui.getintent.com/api/v2/<entity>/all?token=<token>

Response:

{
    "data": {
       "<entity id>" => {<entity data>},
       ...
    }
}

List entities

GET https://ui.getintent.com/api/v2/<entity>/list?token=<token>&custom_fields=<field1>,<field2>,...

Response:

{
    "data": {
       "<entity id>" => {<entity data>},
       ...
    }
}

List method by default returns only object's "id" and "name" fields, additional fields in output are controlled by "custom_fields" parameter.

Create an entity

Use PUT request type, request body should contain appropriate JSON object.

PUT https://ui.getintent.com/api/v2/<entity>/new?token=<token>

Example:

curl --data '{"name": "title",...}' -H 'Content-Type: application/json' -X PUT https://ui.getintent.com/api/v2/<entity>/new?token=<token>

Get entity attributes

GET https://ui.getintent.com/api/v2/<entity>/get/<entity_id>?token=<token>

Example:

curl -X GET https://ui.getintent.com/api/v2/<entity>/get/<entity_id>?token=<token>

Update entity

Use PUT request type, request body should contain appropriate JSON object.

PUT https://ui.getintent.com/api/v2/<entity>/edit/<entity_id>?token=<token>

Example:

curl --data '{"name": "new title",...}' -H 'Content-Type: application/json' -X PUT https://ui.getintent.com/api/v2/<entity>/edit/<entity_id>?token=<token>

Delete entity

DELETE https://ui.getintent.com/api/v2/<entity>/delete/<entity_id>?token=<token>

Example:

curl -X DELETE https://ui.getintent.com/api/v2/<entity>/delete/<entity_id>?token=<token>