BiNuke API's instructions

Основные особенности:

1. Особенности отправки POST запросов:
Система позволяет принимать пост запросы отдельными переменными, либо JSON строкой в виде POST запроса с переменной json
2. Порядок обработки уведомлений и ошибок:
Во всех ответах система может генерировать ряд уведомлений трёх типов: Ошибка, Уведомление и Успех действия
Внутри JSON передаётся параметр error. Если он равен '', то ответ успешный, он обработывается в-первую очередь. Если отдалась строка не пустая, значит действие не выполнено, причина описана в ошибке
Во-вторую очередь, параллельно с переменными ответа, могут отдаваться остальные нотисы в массиве notices, имеющие по 3 параметры каждый, а именно: Тип (error, info, ok), Текст нотиса и опциональный параметр длительности показа в секундах
3. Антикеш:
В запросе можно посылать произвольную рандомную гет переменную для предотвращения кеширования запроса, это неоходимо чтобы встроенные средства каждый раз наверняка запрашивали актуальные данные, но по практике этой необходимости ещё не наблюдалось

Main functions

Authorization:
http://binuke.info/api.php?mode=auth SECURE, 5 errors per hour by ip
!IMPORTANT! POST param: email - E-Mail adress (like name@host.dm)
OR
!IMPORTANT! POST param: phone - Phone number (like +79012345678 or 79012345678 or 89012345678 or 9012345678)
!IMPORTANT! POST param: password - Password string
Answer: application/json; charset=utf-8
error - Notification if error
id - Account id
name - Firt user name
name2 - Last user name
phone - Phone number from account
email - Email from account
session - Session token for another requests

Registration:
api.php?mode=reg , mode=GET , answer: application/json; charset=utf-8
!IMPORTANT! POST param: email - E-Mail adress
!IMPORTANT! POST param: password - Password string
!IMPORTANT! POST param: regname - User real name string
!IMPORTANT! POST param: regfam - User last name string
!IMPORTANT! POST param: phone - mobile phone string

Reminder password:
api.php?mode=forgot , mode=GET , answer: application/json; charset=utf-8
This finction is bugged!!! json answer has included in array like array(array()), for support old app it's not fixed today
!IMPORTANT! POST param: email - E-Mail adress

Social authentification start:
api.php?mode=socialstart , mode=GET , answer: application/json; charset=utf-8

Social authentification:
api.php?mode=socialauth , mode=POST , answer: application/json; charset=utf-8
!IMPORTANT! POST param: token - Result string from ulogin

Onliner and news:
api.php?mode=online , mode=GET , answer: application/json; charset=utf-8
Add GET or POST params: session - session id

License check functions:

LicenseCheck:
http://binuke.info/api.php?mode=LicenseCheck , method=POST , answer: application/json; charset=utf-8
BNLicense must be included in x-auth header

Tickets functions:

TicketList:
http://binuke.info/api.php?mode=TicketList , method=POST , answer: application/json; charset=utf-8
TicketCreate:
http://binuke.info/api.php?mode=TicketCreate , method=POST , answer: application/json; charset=utf-8
TicketRead:
http://binuke.info/api.php?mode=TicketRead , method=POST , answer: application/json; charset=utf-8
TicketPutComment:
http://binuke.info/api.php?mode=TicketPutComment , method=POST , answer: application/json; charset=utf-8
TicketPutFile:
http://binuke.info/api.php?mode=TicketPutFile , method=POST , answer: application/json; charset=utf-8
TicketGetFile:
http://binuke.info/api.php?mode=TicketGetFile , method=POST , answer: file; charset=like file
TicketClose:
http://binuke.info/api.php?mode=TicketClose , method=POST , answer: application/json; charset=utf-8
TicketRate:
http://binuke.info/api.php?mode=TicketRate , method=POST , answer: application/json; charset=utf-8

System update functions:

UpdateCheck:
http://binuke.info/api.php?mode=UpdateCheck , method=POST , answer: application/json; charset=utf-8
UpdateGet
http://binuke.info/api.php?mode=UpdateGet , method=POST , answer: file/zip; charset=utf-8
UpdateSet
http://binuke.info/api.php?mode=UpdateSet , method=POST , answer: application/json; charset=utf-8

Other template integration functions:

TemplateCheckZip:
http://binuke.info/api.php?mode=TemplateCheckZip , method=POST , answer: application/json; charset=utf-8
TemplateCheckUrl:
http://binuke.info/api.php?mode=TemplateCheckUrl , method=POST , answer: application/json; charset=utf-8
TemplateTaskCreate:
http://binuke.info/api.php?mode=TemplateTaskCreate , method=POST , answer: application/json; charset=utf-8
TemplateTaskInfo:
http://binuke.info/api.php?mode=TemplateTaskInfo , method=POST , answer: application/json; charset=utf-8
TemplateGet:
http://binuke.info/api.php?mode=TemplateGet , method=POST , answer: file/zip; charset=utf-8

BiNukeMail functions:

MailSend:
http://binuke.info/api.php?mode=MailSend , method=POST , answer: application/json; charset=utf-8
Attachments array must only Array of urls files
MailList:
http://binuke.info/api.php?mode=MailList , method=POST , answer: application/json; charset=utf-8
MailCheck:
http://binuke.info/api.php?mode=MailCheck , method=POST , answer: application/json; charset=utf-8

BiNukeSocial functions:

SocialAuthVk:
http://binuke.info/api.php?mode=SocialAuthVk , method=POST , answer: application/json; charset=utf-8
BNLicense must be included in x-auth header
SocialStopVk:
http://binuke.info/api.php?mode=SocialStopVk , method=POST , answer: application/json; charset=utf-8
BNLicense must be included in x-auth header
SocialCheck:
http://binuke.info/api.php?mode=SocialCheck , method=POST , answer: application/json; charset=utf-8
BNLicense must be included in x-auth header
SocialPost:
http://binuke.info/api.php?mode=SocialPost , method=POST , answer: application/json; charset=utf-8
BNLicense must be included in x-auth header
SocialQueue:
http://binuke.info/api.php?mode=SocialQueue , method=POST , answer: application/json; charset=utf-8
BNLicense must be included in x-auth header

BiNukeSMS functions:

SMSSend:
http://binuke.info/api.php?mode=SMSSend , method=POST , answer: application/json; charset=utf-8
Attachments array must only Array of urls files
SMSCheck:
http://binuke.info/api.php?mode=SMSCheck , method=POST , answer: application/json; charset=utf-8
SMSList:
http://binuke.info/api.php?mode=SMSList , method=POST , answer: application/json; charset=utf-8
SMSLimit:
http://binuke.info/api.php?mode=SMSLimit , method=POST , answer: application/json; charset=utf-8

BiNuke Telegram functions:

Подробная инструкция: TGApiHelp (HTML, примеры запросов и ответы). Актуальный контракт: TGApiInfo (JSON, версия и список методов). Все запросы TG* направляются в модуль Telegram. JSON-ответы — UTF-8.

TGApiInfo — информация о Telegram API и разрешённых функциях (без лицензии).
TGProxyConfig — публичная конфигурация Telegram-прокси (без лицензии).
TGConnectionStatus — статус бота, правила лицензии и подключение.
TGSend — отправка текста или файла; параметры license, to, body, необязательные filename, fileBase64, topicid (тема Telegram), serviceid (внутренний отдел/филиал проекта, не тема!).
Отправка в тему: передать to=ID группы, topicid=ID темы из TGChatTopics. Параметр serviceid не меняет адрес доставки и служит только для журнала проекта. Подробные примеры: TGSend / темы и serviceid.
TGList — список доступных чатов.
TGgetChat — информация о чате; параметр chatid (учитывать регистр в имени метода).
TGIncomingRecent — последние входящие события; необязательный limit (1–100).
TGAccounts — список доступных по лицензии Telegram-ботов с реальными botId (без токенов и внутренних ID).
Выбор бота: если лицензии назначен один бот, параметр botid не нужен. Если несколько — API ответит bot_id_required и вернёт availableBots; повторите запрос с botid, равным реальному Telegram ID.
TGChats — постраничный список кэшированных чатов назначенного бота.
TGChatInfo — сведения из накопителя по chatid.
TGChatTopics — темы выбранного чата; параметры chatid, page, limit.
TGUsers — постраничный список пользователей, писавших боту после запуска нового накопителя.
TGUserInfo — сведения о пользователе по userid.
TGOutgoingRecent — постраничный журнал сообщений, отправленных текущей лицензией через её бота.
TGWebhookStatus — проверить установку webhook без изменения конфигурации.
Права: для чтения чатов, тем, пользователей и webhook-управления требуется назначенный лицензии выделенный бот. Бот по умолчанию не раскрывает свои накопители сторонним проектам.
TGAccountCreate — подключение собственного бота; параметры name, token (если разрешено политикой лицензии).
TGWebhookEnsure — создание/обновление webhook; изменяет настройки, не использовать для проверки справки.

TGBack — служебный callback для входящих событий, не клиентский метод. Старые TGCheck и TGLimit в Telegram 1.3.2 отсутствуют.

BiNuke WhatsApp functions:

Полная встроенная HTML-инструкция: WAApiHelp — все группы функций WhatsApp, параметры и права доступа.
Машинный контракт: WAApiInfo (JSON).

WASend:
http://binuke.info/api.php?mode=WASend , method=POST , answer: application/json; charset=utf-8
Attachments array must only Array of urls files
WACheck:
http://binuke.info/api.php?mode=WACheck , method=POST , answer: application/json; charset=utf-8
WAList:
http://binuke.info/api.php?mode=WAList , method=POST , answer: application/json; charset=utf-8
WALimit — устаревшее название: в текущем модуле этот метод не найден. Проверяйте состав API через WAApiHelp/WAApiInfo.

BiNuke MAX functions:

Контракт модуля MAX: MAXApiInfo (JSON, доступные методы и правила лицензии). Включает сообщения, чаты, контакты, webhook, личные инстансы и уведомления.

MAXConnectionStatus:
http://binuke.info/api.php?mode=MAXConnectionStatus , method=POST , answer: application/json; charset=utf-8
MAXSend:
http://binuke.info/api.php?mode=MAXSend , method=POST , answer: application/json; charset=utf-8
POST params: phone + body for direct send by phone. Legacy to chatId is supported too.
MAXCheck:
http://binuke.info/api.php?mode=MAXCheck , method=POST , answer: application/json; charset=utf-8
POST param: phone
MAXList:
http://binuke.info/api.php?mode=MAXList , method=POST , answer: application/json; charset=utf-8
MAXLimit — устаревшее название: в текущем модуле этот метод не найден. Действующие методы смотрите в MAXApiInfo.

Backups functions:

BackupCreate:
http://binuke.info/api.php?mode=BackupCreate , method=POST , answer: application/json; charset=utf-8
BackupSendFile:
http://binuke.info/api.php?mode=BackupSendFile , method=POST , answer: application/json; charset=utf-8
BackupList:
http://binuke.info/api.php?mode=BackupList , method=POST , answer: application/json; charset=utf-8
BackupDelete:
http://binuke.info/api.php?mode=BackupDelete , method=POST , answer: application/json; charset=utf-8
BackupGet:
http://binuke.info/api.php?mode=BackupGet , method=POST , answer: file/zip; charset=utf-8

Edit history functions:

HistoryPut:
http://binuke.info/api.php?mode=HistoryPut , method=POST , answer: application/json; charset=utf-8
HistoryList:
http://binuke.info/api.php?mode=HistoryList , method=POST , answer: application/json; charset=utf-8
HistoryGet:
http://binuke.info/api.php?mode=HistoryGet , method=POST , answer: application/json; charset=utf-8
HistoryGetSql:
http://binuke.info/api.php?mode=HistoryGetSql , method=POST , answer: application/json; charset=utf-8

Translate functions:

Translate:
http://binuke.info/api.php?mode=Translate , method=POST , answer: application/json; charset=utf-8
TranslateList:
http://binuke.info/api.php?mode=TranslateList , method=POST , answer: application/json; charset=utf-8
TranslateLangs:
http://binuke.info/api.php?mode=TranslateLangs , method=POST , answer: application/json; charset=utf-8
TranslateLimits:
http://binuke.info/api.php?mode=TranslateLimits , method=POST , answer: application/json; charset=utf-8

p.a.c.k.e.d obfuscation functions:

Obfuscate:
http://binuke.info/api.php?mode=Obfuscate , method=POST , answer: application/json; charset=utf-8

Script registration functions:

ScriptSend:
http://binuke.info/api.php?mode=ScriptSend , method=POST , answer: application/json; charset=utf-8
ScriptList:
http://binuke.info/api.php?mode=ScriptList , method=POST , answer: application/json; charset=utf-8
ScriptStatus:
http://binuke.info/api.php?mode=ScriptStatus , method=POST , answer: application/json; charset=utf-8

CDN functions:

CDNCreate:
http://binuke.info/api.php?mode=CDNCreate , method=POST , answer: application/json; charset=utf-8
CDNList:
http://binuke.info/api.php?mode=CDNList , method=POST , answer: application/json; charset=utf-8
CDNStat:
http://binuke.info/api.php?mode=CDNStat , method=POST , answer: application/json; charset=utf-8
CDNInfo:
http://binuke.info/api.php?mode=CDNInfo , method=POST , answer: application/json; charset=utf-8
CDNGet:
http://binuke.info/api.php?mode=CDNGet , method=POST , answer: file; charset=NO!!!

HARVESTER functions:

HarvesterCreate:
http://binuke.info/api.php?mode=HarvesterCreate , method=POST , answer: application/json; charset=utf-8
HarvesterSendFile:
http://binuke.info/api.php?mode=HarvesterSendFile , method=POST , answer: application/json; charset=utf-8
HarvesterSendUrl:
http://binuke.info/api.php?mode=HarvesterSendUrl , method=POST , answer: application/json; charset=utf-8
HarvesterStart:
http://binuke.info/api.php?mode=HarvesterStart , method=POST , answer: application/json; charset=utf-8
HarvesterList:
http://binuke.info/api.php?mode=HarvesterList , method=POST , answer: application/json; charset=utf-8
HarvesterInfo:
http://binuke.info/api.php?mode=HarvesterInfo , method=POST , answer: application/json; charset=utf-8
HarvesterResult:
http://binuke.info/api.php?mode=HarvesterResult , method=POST , answer: file/zip; charset=utf-8