Как работать с API — полная версия
API-key генерируется в разделе меню API. Там же вы можете увидеть, какой результат возвращают команды.
API-сервер:
http://contentmonster.ru/api/xmlrpc/
Кодировка: UTF-8
Для работы с апи можно использовать готовые библиотеки.
Для php самые известные:
http://pear.php.net/package/XML_RPC2/docs
http://framework.zend.com/manual/en/zen… lient.html
Вы можете посмотреть пример функции на php, которая получает список сайтов аккаунта и выводит его.
Функции
Баланс
(array) contentmonster.balance((string)ApiKey) — проверка баланса
Категории
(array) contentmonster.subjectList((string)ApiKey) — получить список тематик
Списки копирайтеров
Избранные
(array) contentmonster.favorites((string)ApiKey[, (int)site_id=null]) — получить список избранных копирайтеров (весь или по сайтам)
(bool) contentmonster.addtoFav((string)ApiKey, (string)Login[, (int)site_id=0]) — добавить копирайтера в избранные
(bool) contentmonster.removefromFav((string)ApiKey, (string)Login[, (int)site_id=null]) — удалить копирайтера из избранных
Черный список
(array) contentmonster.blacklist((string)ApiKey) — получить список копирайтеров черного списка
(bool) contentmonster.addtoBl((string)ApiKey, (string)Login) — добавить копирайтера в черный список
(bool) contentmonster.removefromBl((string)ApiKey, (string)Login) — удалить из черного списка
Списки сайтов
(array) contentmonster.getSites((string)ApiKey) — получить список сайтов
(bool) contentmonster.addSite((string)ApiKey, (string) Name[, (int)SubjectId=0]) — добавить сайт. SubjectId — тематика.
Заказы
Получение списка заказов
(array) contentmonster.getOrdersId((string)ApiKey [, (int)Status=0] [, (int)SiteId=null]) — возвращает список id заказов со статусом Statsus (по умолчанию Status=0, Черновик), и для сайта SiteId (по умолчанию для всех сайтов).
статусы:
0 — черновик,
2 — прием предложений,
3 — выбор копирайтера,
4 — отправлен копирайтеру,
5 — в работе,
7 — проверка уникальности,
8 — на проверку,
9 — доработка,
10 — просрочен,
12 — закончен,
20 — архив
Создание
(bool) contentmonster.createOrder((string) key, (array) params)
Параметры:
site_id — id сайта. по умолчанию = 0 без сайта
task — Тип задачи 1-Копирайтинг 2-Рерайтинг 3-SEO копирайтинг; по умолчанию 1 -Копирайтинг
subject_id — Тематика обязательно
write_time_limit — Время выполнения заказа. по умолчанию 24
len_min — Количество символов от.по умолчанию 3000
len_max — Количество символов до.по умолчанию 5000
write_pay — цена. обязательно
bezprob — без пробела =1. по умолчанию с пробелом
wmtype — WMZ-0 (по умолчанию) WMR — 1
payall — 1 — Цена за весь заказ; 0 — Цена за 1000 знаков(по умолчанию)
uniq_status — 1 — Автопроверка Monster Antiplagiat Pro; 0 — по умолчанию
uniq_min — минимальная уникальность. 0 — по умолчанию
uniq_note — Ваш способ проверки
name — название
description — Описание заказа. обязательно
keywords — Ключевые слова
mtitle — Создавать Title
min_title — Количество символов от
max_title — до
mdesc — Создавать Description
min_desc — Количество символов от
max_desc — до
autoselect — Автовыбор копирайтера 1 — Лучший 2 — Первый. по умолчанию выключен
autoselectlevel — Уровень копирайтера 1-5. если autoselect=2
nocoment — 1 Запретить комментарии к заказу до выбора исполнителя
tender_type — Разместить 0-индивидуальный заказ 1- на бирже 2-избранные копирайтеры. 1 — по умолчанию
tender_time_limit — если tender_type=1 Принимать предложения в течение часы. по умолчанию 48
tender_group — если tender_type=2 site_id. список избранных копирайтеров по умолчанию 0 (без сайта)
author — если tender_type=0. логин автора для индивидуального заказа
send — если 1 отправляет в работу, резервирует средства если нужно
Изменение
(bool) contentmonster.editOrder((string) key, (integer) order_id, (array) params). Параметры для создания и изменения одинаковые
Управление статусом
(bool) contentmonster.returnOrder((string)ApiKey, (int)OrderId) — отозвать заказ с биржи/от автора. Отозвать модно только если не начата работа.
(bool) contentmonster.deleteOrder((string)ApiKey, (int)OrderId) — удалить заказ. Удалять можно только из черновика.
(bool) contentmonster.reworkOrder((string)ApiKey, (int)OrderId[, (string)message]) — отправить заказ на доработку. Отправить можно только из статусов "на проверку" и "просрочен".
(bool) contentmonster.approveOrder((string) key, (integer) order_id [, (integer) ctype, (string) message, (integer) rate ] ) — принятие заказа. параметры:
order_id — номер закза
ctype — отзыв исполнителю (тип 1 — положительный (по умолчанию), 2 — отрицательный)
message — текст отзыва исполнителю (необязательно)
rate — оценка 1-5 (по умолчанию не задана)
(bool) contentmonster.otkazOrder((string) key, (integer) order_id [, (string) message ] ) — отказ от заказа в статусе Просрочен с переносом заказа в черновики. При этом автоматически ставится отрицательный отзыв.
order_id — номер закза
message — текст отрицательного отзыва (необязательно)
(bool) contentmonster.toArchive((string)ApiKey, (int)OrderId) — перемещает заказ в архив. Если успешно, возвращает 1.
Экспорт
(array) contentmonster.export((string)ApiKey, (int)OrderId) — экспорт готового заказа. Заказ можно получить только если он находится в статусе 8, 12, 20
параметры:
id — OrderId
name -Название
title — Тайтл (если заказывали)
desc — Описание (если заказывали)
text — Текст статьи
write_note — Примечание автора
(array) files — Файлы закачанные автором
[id] => id файла в системе [name] => имя файла [size] => размер в байтах [type] => mime тип [url] => url
