Developers

СПРАВОЧНИКИ

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

offers-types-list
Формат:

GET /api/rest/webmaster/xml/offers-types-list

Описание:

Возвращает список фильтров типов офферов

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

GET /api/rest/webmaster/xml/offers-tools-list

Описание:

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

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

GET /api/rest/webmaster/xml/languages-list

Описание:

Возвращает список языков

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

GET /api/rest/webmaster/xml/geo-list

Описание:

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

Входные параметры:
Ответ:
  • <getGeoListResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <parent_id>int</parent_id>
        • <code>string</code>
        • <count>int</count>
        • <items>
          • <item>
            • <parent_id>int</parent_id>
            • <code>string</code>
            • <count>int</count>
            • <items>
              • <item>
                • <parent_id>int</parent_id>
                • <code>string</code>
                • <count>int</count>
                • <items>
                  • <item></item>
                  </items>
                • <title>string</title>
                • <value>int</value>
                </item>
              </items>
            • <title>string</title>
            • <value>int</value>
            </item>
          </items>
        • <title>string</title>
        • <value>int</value>
        </item>
      </data>
    </getGeoListResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/geo-list?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
offers-categories-list
Формат:

GET /api/rest/webmaster/xml/offers-categories-list/{type}

Описание:

Возвращает список категорий

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
enumtypeweb, mobile
 
Ответ:
  • <getOffersCategoriesListResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <parent_id>int</parent_id>
        • <code>string</code>
        • <count>int</count>
        • <items>
          • <item>
            • <parent_id>int</parent_id>
            • <code>string</code>
            • <count>int</count>
            • <items>
              • <item>
                • <parent_id>int</parent_id>
                • <code>string</code>
                • <count>int</count>
                • <items>
                  • <item></item>
                  </items>
                • <title>string</title>
                • <value>int</value>
                </item>
              </items>
            • <title>string</title>
            • <value>int</value>
            </item>
          </items>
        • <title>string</title>
        • <value>int</value>
        </item>
      </data>
    </getOffersCategoriesListResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/offers-categories-list/web?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
offers-traffictypes-list
Формат:

GET /api/rest/webmaster/xml/offers-traffictypes-list/{type}

Описание:

Возвращает список видов траффика

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
enumtypeweb, mobile
 
Ответ:
  • <getOffersTrafficTypesListResponseData>
    • <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>
    </getOffersTrafficTypesListResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/offers-traffictypes-list/web?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
offers-platforms-list
Формат:

GET /api/rest/webmaster/xml/offers-platforms-list

Описание:

Возвращает список мобильных платформ

Входные параметры:
Ответ:
  • <getOffersMobilePlatformsListResponseData>
    • <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>
    </getOffersMobilePlatformsListResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/offers-platforms-list?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
goods-categories-list
Формат:

GET /api/rest/webmaster/xml/goods-categories-list/{type}

Описание:

Возвращает справочник категорий товаров. Для категорий совпадающих с категориями Яндекс.Маркета указаны идентификаторы категорий Яндекс.Маркета.

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
enumtypegoods, marketplace
 
Ответ:
  • <getGoodsCategoriesListResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <id>int <!--id категории --></id>
        • <parent_id>int <!--id родительской категории--></parent_id>
        • <name>string <!--Название категории--></name>
        • <yandex_category_id>string <!--id Яндекс категории--></yandex_category_id>
        • <offers_count>int <!--количество товаров в офферах категории--></offers_count>
        • <items>
          • <item>
            • <id>int <!--id категории --></id>
            • <parent_id>int <!--id родительской категории--></parent_id>
            • <name>string <!--Название категории--></name>
            • <yandex_category_id>string <!--id Яндекс категории--></yandex_category_id>
            • <offers_count>int <!--количество товаров в офферах категории--></offers_count>
            • <items>
              • <item>
                • <id>int <!--id категории --></id>
                • <parent_id>int <!--id родительской категории--></parent_id>
                • <name>string <!--Название категории--></name>
                • <yandex_category_id>string <!--id Яндекс категории--></yandex_category_id>
                • <offers_count>int <!--количество товаров в офферах категории--></offers_count>
                • <items>
                  • <item></item>
                  </items>
                </item>
              </items>
            </item>
          </items>
        </item>
      </data>
    </getGoodsCategoriesListResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/goods-categories-list/goods?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
goods-brands-list
Формат:

GET /api/rest/webmaster/xml/goods-brands-list/{type}

Описание:

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

Входные параметры:
Тип:Имя:Описание:Допустимые значения:Обязательное:
enumtypegoods, marketplace
 
Ответ:
  • <getGoodsBrandsListResponseData>
    • <status>
        200|204|400|403|500|
      </status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <value>int</value>
      • <title>string</title>
      • <items>
        • <item>
          • <id>int</id>
          • <name>string</name>
          • <offers_count>int</offers_count>
          • <title>string</title>
          • <value>int</value>
          </item>
        </items>
      </data>
    </getGoodsBrandsListResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/goods-brands-list/goods?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
goods-currency-list
Формат:

GET /api/rest/webmaster/xml/goods-currency-list

Описание:

Возвращает справочник валют каталога товаров

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

GET /api/rest/webmaster/xml/couponstatus

Описание:

Возвращает справочник статусов, которые определяют состояние активности купона

Входные параметры:
Ответ:
  • <getCouponStatusResponseData>
    • <status>int</status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <id>int</id>
        • <name>string</name>
        • <description>string</description>
        </item>
      </data>
    </getCouponStatusResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/couponstatus?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
couponcategories
Формат:

GET /api/rest/webmaster/xml/couponcategories

Описание:

Возвращает справочник категорий купонов

Входные параметры:
Ответ:
  • <getCouponCategoriesResponseData>
    • <status>int</status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <id>int</id>
        • <name>string</name>
        </item>
      </data>
    </getCouponCategoriesResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/couponcategories?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
couponscopes
Формат:

GET /api/rest/webmaster/xml/couponscopes

Описание:

Возвращает справочник зон действия купонов

Входные параметры:
Ответ:
coupontypes
Формат:

GET /api/rest/webmaster/xml/coupontypes

Описание:

Возвращает справочник типов (Промокод, Акция и т.д.) купонов

Входные параметры:
Ответ:
  • <getCouponTypesResponseData>
    • <status>int</status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <id>int</id>
        • <name>string</name>
        </item>
      </data>
    </getCouponTypesResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/coupontypes?remote_auth=6420072d37bf14f1df182d0fe0efa2d9
couponother
Формат:

GET /api/rest/webmaster/xml/couponother

Описание:

Список дополнительных фильтров для списка купонов

Входные параметры:
Ответ:
  • <getCouponOtherResponseData>
    • <status>int</status>
    • <error>string</error>
    • <request_id>int</request_id>
    • <data>
      • <item>
        • <id>int</id>
        • <name>string</name>
        </item>
      </data>
    </getCouponOtherResponseData>
Пример:
http://cityads.com/api/rest/webmaster/xml/couponother?remote_auth=6420072d37bf14f1df182d0fe0efa2d9