Developers

Инструменты

Описание методов API

banner-sizes-list
Формат:

GET /api/rest/webmaster/xml/banner-sizes-list

Описание:

Возвращает список размеров баннеров

Входные параметры:
Ответ:
  • <getBannerSizesResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <id>int</id>
        • <name>string</name>
        </item>
      </data>
    </getBannerSizesResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/banner-sizes-list?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
rotators
Формат:

GET /api/rest/webmaster/xml/rotators?start=<int>&limit=<int>

Описание:

Возвращает данные о ротаторах баннеров

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
intstart
 
intlimit
 
Ответ:
  • <getRotatorsResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <total>int</total>
      • <items>
        • <item>
          • <id>int</id>
          • <name>string</name>
          • <subaccount>string</subaccount>
          • <added_at>dateTime</added_at>
          • <type>
              flash|image|all|
            </type>
          • <offers_included>
            • <item>
              • <id>int</id>
              • <name>string</name>
              </item>
            </offers_included>
          • <offers_excluded>
            • <item>
              • <id>int</id>
              • <name>string</name>
              </item>
            </offers_excluded>
          • <add_new_offers>
              0|1|
            </add_new_offers>
          • <banner_sizes>
            • <item>string</item>
            </banner_sizes>
          • <category_included>
            • <item>
              • <id>int</id>
              • <name>string</name>
              </item>
            </category_included>
          • <category_excluded>
            • <item>
              • <id>int</id>
              • <name>string</name>
              </item>
            </category_excluded>
          • <banners_included>
            • <item>
              • <id>int</id>
              • <name>string</name>
              </item>
            </banners_included>
          • <banners_excluded>
            • <item>
              • <id>int</id>
              • <name>string</name>
              </item>
            </banners_excluded>
          • <enable_optimization>
              0|1|
            </enable_optimization>
          • <code>
            • <item>
              • <value>string</value>
              • <type>
                  JS_CODE|JS_CODE_ASYNC|XML_FEED|
                </type>
              </item>
            </code>
          </item>
        </items>
      </data>
    </getRotatorsResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/rotators?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
rotator
Формат:

GET /api/rest/webmaster/xml/rotator/{id}

Описание:

Возвращает данные о ротаторе баннеров

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
intid
 
Ответ:
  • <getRotatorResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <id>int</id>
      • <name>string</name>
      • <subaccount>string</subaccount>
      • <added_at>dateTime</added_at>
      • <type>
          flash|image|all|
        </type>
      • <offers_included>
        • <item>
          • <id>int</id>
          • <name>string</name>
          </item>
        </offers_included>
      • <offers_excluded>
        • <item>
          • <id>int</id>
          • <name>string</name>
          </item>
        </offers_excluded>
      • <add_new_offers>
          0|1|
        </add_new_offers>
      • <banner_sizes>
        • <item>string</item>
        </banner_sizes>
      • <category_included>
        • <item>
          • <id>int</id>
          • <name>string</name>
          </item>
        </category_included>
      • <category_excluded>
        • <item>
          • <id>int</id>
          • <name>string</name>
          </item>
        </category_excluded>
      • <banners_included>
        • <item>
          • <id>int</id>
          • <name>string</name>
          </item>
        </banners_included>
      • <banners_excluded>
        • <item>
          • <id>int</id>
          • <name>string</name>
          </item>
        </banners_excluded>
      • <enable_optimization>
          0|1|
        </enable_optimization>
      • <code>
        • <item>
          • <value>string</value>
          • <type>
              JS_CODE|JS_CODE_ASYNC|XML_FEED|
            </type>
          </item>
        </code>
      </data>
    </getRotatorResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/rotator?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
rotator
Формат:

PUT /api/rest/webmaster/xml/rotator

Описание:

Изменяет данные ротатора баннеров

Входной PUT-запрос в формате XML:
  • <setRotatorRequestData>
    • <id>int <!--Id ротатора--></id>
    • <name>string <!--Название ротатора--></name>
    • <subaccount>string <!--Название субаккаунта--></subaccount>
    • <type> <!--Вид промо-->
        flash|image|all|
      </type>
    • <offers_included> <!--Подключенные офферы (при пустом списке - подключаются все доступные офферы)-->
      • <item>int</item>
      </offers_included>
    • <offers_excluded> <!--Исключенные офферы (при пустом списке - все текущие "исключенные офферы" удаляются)-->
      • <item>int</item>
      </offers_excluded>
    • <add_new_offers> <!--Добавлять новые офферы-->
        0|1|
      </add_new_offers>
    • <banner_sizes> <!--Размеры баннеров (при пустом списке - используются доступные размеры)-->
      • <item>string</item>
      </banner_sizes>
    • <category_included> <!--Подключенные категории (при пустом списке - подключаются все доступные категории)-->
      • <item>int</item>
      </category_included>
    • <category_excluded> <!--Исключенные категории (при пустом списке - все текущие "исключенные категории" удаляются)-->
      • <item>int</item>
      </category_excluded>
    • <banners_included> <!--Подключенные баннеры (при пустом списке - все доступные баннеры)-->
      • <item>int</item>
      </banners_included>
    • <banners_excluded> <!--Исключенные баннеры (при пустом списке - все текущие "исключенные баннеры" удаляются)-->
      • <item>int</item>
      </banners_excluded>
    • <enable_optimization> <!--Включить оптимизацию-->
        0|1|
      </enable_optimization>
    </setRotatorRequestData>
Ответ:
  • <setRotatorResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>boolean</data>
    </setRotatorResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/rotator?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
rotator
Формат:

POST /api/rest/webmaster/xml/rotator

Описание:

Создает ротатор баннеров

Входной POST-запрос в формате XML:
  • <createRotatorRequestData>
    • <name>string <!--Название ротатора--></name>
    • <subaccount>string <!--Название субаккаунта--></subaccount>
    • <type> <!--Вид промо-->
        flash|image|all|
      </type>
    • <offers_included> <!--Подключенные офферы-->
      • <item>int</item>
      </offers_included>
    • <offers_excluded> <!--Исключенные офферы-->
      • <item>int</item>
      </offers_excluded>
    • <add_new_offers> <!--Добавлять новые офферы-->
        0|1|
      </add_new_offers>
    • <banner_sizes> <!--Размеры баннеров-->
      • <item>string</item>
      </banner_sizes>
    • <category_included> <!--Подключенные категории-->
      • <item>int</item>
      </category_included>
    • <category_excluded> <!--Исключенные категории-->
      • <item>int</item>
      </category_excluded>
    • <banners_included> <!--Подключенные баннеры-->
      • <item>int</item>
      </banners_included>
    • <banners_excluded> <!--Исключенные баннеры-->
      • <item>int</item>
      </banners_excluded>
    • <enable_optimization> <!--Включить оптимизацию-->
        0|1|
      </enable_optimization>
    </createRotatorRequestData>
Ответ:
  • <createRotatorResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <id>int</id>
      </data>
    </createRotatorResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/rotator?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
banners
Формат:

GET /api/rest/webmaster/xml/banners?start=<int>&limit=<int>&term=<string>

Описание:

Возвращает список баннеров

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
intstart
 
intlimit
 
stringtermстрока поиска по ключевому слову в названии оффера или промо-материала
 
Ответ:
  • <getBannersResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <id>int</id>
        • <name>string</name>
        </item>
      </data>
    </getBannersResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/banners?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
postback-list
Формат:

GET /api/rest/webmaster/xml/postback-list?start=<int>&limit=<int>&term=<string>

Описание:

Возвращает список conversion postback`ов

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
intstart
 
intlimit
 
stringterm
 
Ответ:
  • <getPostbacksResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <id>int</id>
        • <name>string</name>
        • <url>string</url>
        • <action_type>
            0|cpl|cpa|
          </action_type>
        • <request_type>
            post|get|google_upload_offline_conversion|microsoft|facebook|
          </request_type>
        • <status>
            1|2|3|
          </status>
        • <comment>string</comment>
        • <query_params>
          • <item>
            • <name>string</name>
            • <value>string</value>
            </item>
          </query_params>
        • <offers_included>
          • <item>int</item>
          </offers_included>
        </item>
      </data>
    </getPostbacksResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/postback-list?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
postback
Формат:

GET /api/rest/webmaster/xml/postback?id=<int>

Описание:

Возвращает conversion postback`ов

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
intid
 
Ответ:
  • <getPostbackResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <id>int</id>
      • <name>string</name>
      • <url>string</url>
      • <action_type>
          0|cpl|cpa|
        </action_type>
      • <request_type>
          post|get|google_upload_offline_conversion|microsoft|facebook|
        </request_type>
      • <status>
          1|2|3|
        </status>
      • <comment>string</comment>
      • <query_params>
        • <item>
          • <name>string</name>
          • <value>string</value>
          </item>
        </query_params>
      • <offers_included>
        • <item>int</item>
        </offers_included>
      </data>
    </getPostbackResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/postback?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
postback
Формат:

PUT /api/rest/webmaster/xml/postback

Описание:

Изменяет conversion postback`ов

Входной PUT-запрос в формате XML:
  • <setPostbackRequestData>
    • <id>int <!--Id постбека--></id>
    • <name>string <!--Название постбека--></name>
    • <url>string <!--Postback URL--></url>
    • <action_type> <!--Тип действия-->
        all|cpl|cpa|
      </action_type>
    • <request_type> <!--Тип запроса-->
        post|get|google_upload_offline_conversion|microsoft|facebook|
      </request_type>
    • <query_params> <!--Допускаются имена подходящие под регулярное выражение /^[a-z0-9_]+$/i-->
      • <offer_id>string</offer_id>
      • <offer_name>string</offer_name>
      • <wp_id>string</wp_id>
      • <wp_name>string</wp_name>
      • <site>string</site>
      • <subaccount>string</subaccount>
      • <action_type>string</action_type>
      • <target_id>string</target_id>
      • <target_name>string</target_name>
      • <payout_id>string</payout_id>
      • <payout>string</payout>
      • <payout_currency>string</payout_currency>
      • <click_id>string</click_id>
      • <click_time>string</click_time>
      • <event_time>string</event_time>
      • <conversion_time>string</conversion_time>
      • <ip>string</ip>
      • <country>string</country>
      • <city>string</city>
      • <ua>string</ua>
      • <user_browser>string</user_browser>
      • <user_os>string</user_os>
      • <user_device>string</user_device>
      • <cpl_id>string</cpl_id>
      • <open_commission>string</open_commission>
      • <order_amount>string</order_amount>
      • <status>string</status>
      </query_params>
    • <offers_included> <!--Список подключенных офферов (при пустом списке - текущие "подключенные офферы" для postback`a будут удалены. Если в массиве присутствует 0, тогда подключаются все доступные офферы-->
      • <item>int</item>
      </offers_included>
    </setPostbackRequestData>
Ответ:
  • <setPostbackResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>boolean</data>
    </setPostbackResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/postback?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
postback
Формат:

POST /api/rest/webmaster/xml/postback

Описание:

Создает conversion postback`ов

Входной POST-запрос в формате XML:
  • <createPostbackRequestData>
    • <name>string <!--Название постбека--></name>
    • <url>string <!--Postback URL--></url>
    • <action_type> <!--Тип действия-->
        all|cpl|cpa|
      </action_type>
    • <request_type> <!--Тип запроса-->
        post|get|google_upload_offline_conversion|microsoft|facebook|
      </request_type>
    • <query_params> <!--Допускаются имена подходящие под регулярное выражение /^[a-z0-9_]+$/i-->
      • <offer_id>string</offer_id>
      • <offer_name>string</offer_name>
      • <wp_id>string</wp_id>
      • <wp_name>string</wp_name>
      • <site>string</site>
      • <subaccount>string</subaccount>
      • <action_type>string</action_type>
      • <target_id>string</target_id>
      • <target_name>string</target_name>
      • <payout_id>string</payout_id>
      • <payout>string</payout>
      • <payout_currency>string</payout_currency>
      • <click_id>string</click_id>
      • <click_time>string</click_time>
      • <event_time>string</event_time>
      • <conversion_time>string</conversion_time>
      • <ip>string</ip>
      • <country>string</country>
      • <city>string</city>
      • <ua>string</ua>
      • <user_browser>string</user_browser>
      • <user_os>string</user_os>
      • <user_device>string</user_device>
      • <cpl_id>string</cpl_id>
      • <open_commission>string</open_commission>
      • <order_amount>string</order_amount>
      • <status>string</status>
      </query_params>
    • <offers_included> <!--Список подключенных офферов (при пустом списке - текущие "подключенные офферы" для postback`a будут удалены. Если в массиве присутствует 0, тогда подключаются все доступные офферы-->
      • <item>int</item>
      </offers_included>
    </createPostbackRequestData>
Ответ:
  • <createPostbackResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <id>int</id>
      </data>
    </createPostbackResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/postback?remote_auth=6420072d37bf14f1df182d0fe0efa2d9