Get Security Settings for Placement

Get security settings for the Placement with given ID.

URL: /rest-api/security-settings/placement.do
Method: GET
Response format: application/json

Error codes:

  • 401 Unauthorized – authentication error.

Response sample:

200 OK
[{"id":1,"name":"Kids & Teens"},{"id":2,"name":"News"}, ... ] { "forensiqSettings": {"trafficShare": 5, "trafficQualityFiltering": "ACCEPT_ALL", "dateTo": { "formatted": "16/08/2016", "timestamp": 1471294800000 }, "countries": ["UA", "US"], ..., "mediaScannerSettings": { "mediaScannerEndDate": { "formatted": "16/08/2016", "timestamp": 1471294800000 }, "mediaScannerRate": 24, ... }

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • id – placement ID.

Update Security Settings for Placement

Update Security Settings for the Placement with given ID.

URL: /rest-api/security-settings/placement/save.do
Method: POST
Response format: application/json

Error codes:

  • 401 Unauthorized – authentication error.

Request example:

{
"mediaScannerOn": true, "mediaScannerStartDate": "2016-07-27", "mediaScannerEndDate": "2016-08-16", "mediaScannerRate": "24",
"forensiqOn": true, "countries": ["UA","US"],"dateFrom": "2016-07-27", "dateTo": "2016-08-16", "trafficQualityFiltering": "ACCEPT_ALL", "trafficShare": "5.0", "trafficQualityMaxRisk": "50"
}

Response sample:
200 OK
{ "success" : true }

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • id – Placement ID.
  • mediaScannerOn – (required) enable/disable media scanner settings; boolean.
  • mediaScannerStartDate – (required) start date for media scanner in yyyy-MM-dd format.
  • mediaScannerEndDate – (required) end date for media scanner in yyyy-MM-dd format.
  • mediaScannerRate – (required) media scanner rate.
  • forensiqOn – (required) enable/disable forensiq; boolean.
  • countries – (optional) array of country codes.
  • adEvents – (optional) array of ad events to set. Available values: REQUEST, IMPRESSION, CLICK, ACTION.
  • dateFrom – (required) start date for forensiq in yyyy-MM-dd format.
  • dateTo – (required) end date for forensiq in yyyy-MM-dd format.
  • trafficQualityFiltering – (required) traffic quality filtering. Available values: ACCEPT_ALL, REJECT_HIGH_RISK, REJECT_SUSPICIOUS or REJECT_CUSTOM.
  • trafficShare – (required) traffic share as a double.
  • trafficQualityMaxRisk – (required) traffic share as integer.

Disable Security Settings for Placement

Disables all security settings for the Placement with given ID.

URL: /rest-api/security-settings/placement/disable.do
Method: POST

Error codes:

  • 401 Unauthorized – authentication error.

Response format: application/json

Response sample:
200 OK
{ "success": true }

Parameters:

  • hash – an MD5 digest of a concatenated username's MD5 password and a given timestamp.
  • timestamp – UNIX timestamp in milliseconds used in hash generation.
  • username – the given username.
  • id – placement ID.

Need more help?

Should you require any additional help with our solutions, do not hesitate to contact Epom technical support at support@epom.com. Our support managers are dedicated to resolving any issues and providing you with solutions and support if you face difficulties or have questions.