Описание Liex API SOAP WebService
Ссылки:
- это ссылка на wsdl.
- каждый метод сервиса и его параметры описаны в документации.
- также Вы можете скачать тест.
На данный момент с помощью API можно создавать (удалять, изменять) кампании и группы кампаний. В кампанию можно добавить (удалить, изменить) тексты статей и авторежимы. Кроме того можно создать (удалить, изменить) белые списки площадок и фильтры для их поиска. Api позволяет также искать площадки, размещать (удалять) на них статьи.
Все методы API требуют логин пользователя и MD5 хеш пароля пользователя.
Все объекты, возвращаемые API, представляются объектом ObjectBean, который имеет 2 поля:
- id - содержит уникальный идентификатор объекта в бирже.
- properties - содержит xml, описывающий свойства объекта. В процессе развития биржи свойства объекта могут добавляться или удаляться. Поэтому сразу пишите код разбора xml с этим расчетом. Элементы xml для каждого объекта описаны в документации соответствующего метода.
Пример использования:
- Создаем группу кампаний. Для этого используем метод createCampaignGroup. Запоминаем идентификатор созданной группы.
- Создаем кампанию в этой группе. Для этого используем метод createCampaign с использованием идентификатора группы (или можно получить список групп с помощью getCampaignGroupsForUser), предварительно получаем список доступных тематик с помощью метода getSubjects. Запоминаем идентификатор созданной кампании.
- Добавляем статью в кампанию. Для этого используем метод createArticle с использованием идентификатора кампании (или можно получить список кампаний с помощью getCampaignsForGroupили getCampaignsForUser), Запоминаем идентификатор созданной статьи.
- Создаем фильтр для поиска площадок. Для этого используем метод createFilter, предварительно получаем список доступных тематик, языков, регионов с помощью getSubjects, getLangs,getRegions. Запоминаем идентификатор созданного фильтра.
- Находим площадки удовлетворяющие требованиям кампании и фильтра. Для этого используем методfindWebsites с использованием идентификаторов кампании и фильтра (можно использоватьgetFiltersForUser для выбора нужно фильтра). Запоминаем список идентификаторов найденных площадок.
- Выбираем подходящие площадки и размещаем статью с помощью метода offerArticle.
- Проверяем свой баланс с помощью getBalanceInfo.
- Удаляем размещенные статьи. Для этого получаем список размещенных статей с помощью методовgetContractsForCampaign или getContractsForUser и удаляем с помощью метода deleteContract.