API для работы в MainLink

sok

Следующие операции поддерживаются. Формальное определение см. в Описание службы.

  • sok_ActivatePages
    активировать группу страниц
    вход: [SiteID] #сайта, [Codition] условие, [Activate] true - активировать, false - деактивировать
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт другого пользователя, [-4] условие отбраковано, [int] кол-во удаленных страниц
  • sok_BalanceActual
    получить доступный баланс пользователя
    вход: [BalanceType] тип баланса (0 - $, 1 - р.), [UserID] UserID
    выход: [double] сумма доступного баланса, -1- авторизация нарушена
  • sok_BlockUser_Finish
    Блокировка пользователя при переводе из СОКа в ML и обратно
    вход: [UserID] UserID, [block] 1 - ToSok 0 - ToML
    выход: [1] -ok, [-1] авторизация нарушена, [-2] ошибка
  • sok_BlockUser_Start
    Блокировка пользователя при переводе из СОКа в ML и обратно
    вход: [UserID] UserID, [block] 1 - ToSok 0 - ToML
    выход: [1] -ok, [-1] авторизация нарушена, [-2] ошибка
  • sok_CheckUser
    проверка уникальности Login пользователя
    вход: [Login] логин
    выход: [int] UserID, [-1] авторизация СОКа нарушена, [-2] Login уже встречается
  • sok_CurrencyExchange
    провести конвертацию рублевого баланса в долларовый, СОК привязан к UserID
    вход: [UserID] UserID, [Sum] Сумма конвертации - положительная сумма
    выход: [1] ok, [-1] авторизация СОКа нарушена, [-2] ошибка, [-3] Сумма отрицательная, [-4] Средств на рублевом балансе не достаточно
  • sok_CurrencyExchangeTotal
    провести конвертацию рублевого баланса в долларовый, СОК привязан к UserID
    вход: [UserID] UserID
    выход: [1] ok, [-1] авторизация СОКа нарушена, [-2] ошибка, [-3] Сумма<=0, [-4] Средств на рублевом балансе не достаточно
  • sok_DeletePages
    удалить группу страниц
    вход: [SiteID] #сайта, [Codition] условие удаления
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт другого пользователя, [-4] условие отбраковано, [int] кол-во удаленных страниц
  • sok_DoLink
    произвести действие над ссылкой
    вход: [LinkID] #ссылки, [Operation] Операция (1 - одобрить размещение (если еще не одобрена), 2 - списать, 3 - добавить в избранное , 4 - списать и занести в Черный список, 5 - Проверить размещение на странице)
    выход: [-3] ссылки не найдено, [-2] страницы не существует, [-1] ошибка, [0] авторизация не прошла, [LinkID] успешно
  • sok_GetSiteSEOData
    MLAPI: получить текущий набор SEO-параметров для сайта из СОКа
    вход: [SiteID] #сайта
    выход: [массив] изменения параметров
  • sok_GetUser
    получить пользователя по СОКу по UserID
    вход: [UserID] UserID
    выход: объект UserProfile
  • sok_GetUser_byLogin
    получить пользователя по СОКу по UserID
    вход: [UserID] UserID
    выход: объект UserProfile
  • sok_GetUsers
    получить пользователей по СОКу - СОК привязан к UserID
  • sok_MoneyOut
    провести вывод средств пользователю, СОК привязан к UserID
    вход: [UserID] UserID, [Sum] Сумма вывода - положительная сумма, [Information] доп. строка-пояснение в разделе Денежные операции, [BalanceType] 0 - долларовый баланс, 1 - рублевый баланс
    выход: [1] ok, [-1] авторизация СОКа нарушена, [-2] ошибка, [-3] Сумма отрицательная, [-4] Средств на балансе не достаточно
  • sok_MoveCatalogToNewUser
    Перевод сайта на другой аккаунт
    вход: [SiteID] #сайта, [oldUserID] #пользователя (от которого перенос) ДОЛЖЕН БЫТЬ ПРИВЯЗАН К СОКу, [newUserID] #пользователя, куда переводить сайт
    выход: [int] SiteID - ok, [-1] авторизация СОКа нарушена, [-2] сайт не найден, [-3] сайт не принадлежит пользователю; [-4] нового пользователя не существует
  • sok_MoveCatalogToNewUserHavingAccessToSite
    Перевод сайта на другой аккаунт
    вход: [domain] домен в формате www.site.ru или site.ru, [newUserID] #пользователя, куда переводить сайт (должен быть привязан к СОКу
    выход: [int] SiteID - ok, [-1] авторизация СОКа нарушена, [-2] нового пользователя не существует, [-3] сайт не найден, [-4] авторизация сайта не прошла
  • sok_MoveUserToMainLink
    Перевод пользователя в MAINLINK
    вход: [Login] Login, [MD5Password] Пароль
    выход: [int] UserID - ok, [-1] авторизация СОКа нарушена, [-2] пользователь не авторизован
  • sok_MoveUserToSok
    Перевод пользователя в SOK
    вход: [Login] Login, [MD5Password] Пароль
    выход: [int] UserID - ok, [-1] авторизация СОКа нарушена, [-2] авторизация пользователя не прошла, [-3] пользователя нет (!!), [-5] операция не прошла, проводите повторно, [-10] пользователь блокирован, проверять - через sok_LogIn
  • sok_RegisterUser
    Регистрация пользователя - СОК привязан к UserID
    вход: [Login] логин, [Name] ФИО
    выход: [int] UserID, [-1] ошибка в функции регистрации, [-3] авторизация СОКа нарушена, [-2] Login уже встречается
  • sok_SetActualBalance
    Рассчитать доступный баланс пользователя
    [UserID] UserID
    выход: [UserID] OK, -1- авторизация нарушена
  • sok_StartScanning
    отправить на пересканирование сайт
    вход: [SiteID] #сайта
    выход: [-1] сайт в процессе cканирования, [-2] сайт сканировался менее 6 часов назад, [-3] сайт под продажу сквозных ссылок, [SiteID] поставлен в очередь
  • sok_UpdateCountLinks
    установить макс. кол-во ссылок на группе страниц
    вход: [SiteID] #сайта, [maxhop] макс. кол-во, [TIP] тип (0 - ссылка, 1 - заметка), [Codition] условие обновления
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт другого пользователя, [-4] условие отбраковано, [SiteID] обновлено
  • sok_UpdatePrice
    установить цену на группе страниц
    вход: [SiteID] #сайта, [Price] Цена, [BalanceType] валюта (0-$, 1-руб), [TIP] тип (0 - ссылка, 1 - заметка), [Codition] условие обновления
    выход: [-1] ошибка, [-2] сайта нет, [-3] сайт другого пользователя, [-4] условие отбраковано, [SiteID] обновлено
  • sok_UpdateUser
    Изменения данных пользователя - СОК привязан к UserID
    вход: [UserID] UserID, [newName] ФИО
    выход: [int] UserID - ok, [-1] авторизация СОКа нарушена, [-2] ошибка
  • sok_getActiveBalance
    получить статистику по изменению доступного баланса
    вход: [UserID] UserID, [BalanceType] тип баланса (0 - $, 1 - р.), C [DayFrom] день, [MonthFrom] месяц, [YearFrom] год ПО [DayTo] день, [MonthTo] месяц, [YearTo] год
    выход: [массив] история изменений
  • sok_getScanStatus
    получить статус сканирования сайта
    вход: [SiteID] #сайта
    выход: [int] кол-во отсканированных страниц к текущему обращению (сайт в процессе сканирования), [-1] сайт в очереди на сканирование, [-2] сайт отсканирован, [-3] сайт еще не сканировался, [-5] ошибка (писать в суппорт)
  • sok_getSecurCode
    Получить secur'ный код пользователя
    вход: [Login] логин
    выход: [string] UserID, [пусто] авторизация СОКа нарушена
  • sok_getSiteStat
    получить статистику по пользователю за период
    вход: [UserID] UserID, C [DayFrom] день, [MonthFrom] месяц, [YearFrom] год ПО [DayTo] день, [MonthTo] месяц, [YearTo] год
    выход: [массив] массив транзакций
  • sok_getTransactions
    получить перечень типов транзакций
    вход: -
    выход: [массив] типы транзакций
  • sys_LogIn
    LOGIN
    вход: [Login] логин, [Password] пароль
    выход: [string] PASSWORD - не подходит пароль, NOUSER - нет юзера, "" - успешно вошел, <> "" - выведет за что забанен