Channel Management

getChannelListByAgencyId

Description: Get all channels from selected agency

Implementation: URL/chn/agc/[agencyId]

Method: GET

Json example

Method: 
    GET http://api.example.com/chn/agc/1

getChannelListByWebsiteId

Description: Get all channels from selected website

Implementation: URL/chn/website/[websiteId]

Method: GET

Json example

Method: 
    GET http://api.example.com/chn/website/1

getChannel

Description: Get existing channel

Implementation: URL/chn/[channelId]

Method: GET

Json example

Method: 
    GET http://api.example.com/chn/1

addChannel

Description: Add new channel

Implementation: URL/chn/new

Method: POST/PUT

Requested parameters

addChannel
Name Description: Allowed Values Required / Optional Default
channelName channel name string required
agencyId agency ID int optional null
websiteId website ID int optional null
Description: channel Description: string optional null
comments comments string optional null

Json example

Method: 
    POST http://api.example.com/chn/new
Request Header:
    Content-Type:text/javascript
Request Body:
    {
        "channelName":"My new channel",
        "agencyId":1,
        "websiteId":1,
        "Description: ":"test channel Description: ",
        "comments":"test channel comments"
    }

modifyChannel

Description: Modify existing channel

Implementation: URL/chn/[channelId]

Method: POST/PUT

Requested parameters

modifyChannel
Name Description: Allowed Values Required / Optional Default
channelName channel name string optional null
agencyId agency ID int optional null
websiteId website ID int optional null
Description: channel Description: string optional null
comments comments string optional null

Json example

Method: 
    POST http://api.example.com/chn/4
Request Header:
    Content-Type:text/javascript
Request Body:
    {
        "channelName":"My new channel",
        "agencyId":1,
        "websiteId":1,
        "Description: ":"test channel Description: ",
        "comments":"test channel comments"
    }

deleteChannel

Description: Delete existing channel

Implementation: URL/chn/[channelId]

Method: DELETE

Json example

Method: 
    DELETE http://api.example.com/chn/4

getChannelTargeting

Description: Returns all channel’s delivery limitations

Implementation: URL/bnn/[channelId]/targeting

Method: GET

Json example

Method: 
    GET http://api.example.com/chn/1/targeting

setChannelTargeting

Description: Sets delivery limitation for particular channel. All previous delivery limitation for the channel will be deleted.

Implementation: URL/chn/[channelId]/targeting

Method: POST/PUT

Parameters

channel targeting
Name Description: Allowed Values Required / Optional Default
logical logical parameter enum(and,or) required
type type of the delivery limitation string required
comparation type of comparation enum (=~,!=~,==,!=,>,<….) required
data comparation data string required

Json example

Method: 
    POST http://api.example.com/chn/1/targeting
Request Body:
[
    {
        "logical": "and",
        "type": "deliveryLimitations:Client:Browser",
        "comparison": "=~",
        "data": "FX,MZ,OP"
    },
    {
        "logical": "and",
        "type": "deliveryLimitations:Client:Ip",
        "comparison": "!=",
        "data": "10.0.0.1"
    }
]

Current version

The most recently released version of the Revive Adserver REST API is v5.2.0 (publication date April 18, 2024).

See Release Notes

Compatibility

Revive Adserver REST API is compatible with all versions of Revive Adserver v4.x, and v5.x. It may also be compatible with Revive Adserver v3.x (and also with OpenX Source v2.8 and higher), but this can not be guaranteed.

Revive Adserver REST API is compatible with all supported versions of PHP, including PHP 7 and PHP  8.

Also see Technical Requirements, Product Content, and Installation Instructions.

Sorting 'Lst' output

Version 5.2.0 (released April 18, 2024)) introduced the ability to sort the output of the 'list' feature by any of the available columns (in ascending or descending order), and to limit the number of rows of the output. This is supported for the List output of any of the categories.

Please see the generic Documentation for the sort order output of lists.