u/Stiletto/BnW/API142014-06-05 11:52:47Кур_КумитStop shitediting ffs132014-06-05 10:48:54localhost122012-08-02 16:00:36ip-91-103-156-182.pntl.ruболее подробное описание112012-07-11 09:43:56Kagami(м)102012-07-11 09:43:04Kagami92012-07-10 21:20:24Kagamiссылки82012-07-10 21:08:18KagamiRenamed from 'u/Stiletto/bnw/API'.72012-07-10 21:04:56Kagami(м)62012-07-10 21:03:11KagamiТак красивше.52012-07-10 21:02:33Kagami42012-07-10 21:01:25Kagami32011-07-31 09:28:36Stiletto22011-07-31 09:28:20Stiletto12011-07-31 09:27:53StilettoAPIФункции HTTP-API BnW дублируют команды красноглазого интерфейса (используются только длинные версии команд и аргументов). Взаимодействие с сервером происходит с помощью GET или POST запросов (на выбор пользователя), ответы выдаются в виде JSON. В зависимости от успешности выполнения запроса, параметр ok
в ответе принимает значения true
или false
. Если запрос неуспешен, то параметр desc
будет содержать причину ошибки. Если функция требует авторизации, необходимо передать параметр login
равный loginkey пользователя, который можно получить, отправив боту команду login
. Примеры запросов Команда URL запроса Ответ
Список командhttps://bnw.im/api/
{"commands": ["feed", "comment", "show", "clubs", "tags", "recommend", "subscriptions/del", "today", "pm", "stat", "subscriptions", "update", "blacklist", "passlogin", "interface", "post", "vcard", "on", "search", "subscriptions/add", "off", "register", "userlist", "delete"], "ok": true}
Создание постаhttps://bnw.im/api/post?text=пук+уау&login=1234567890abcdef
{"ok": true, "id": "0XYNTA", "desc": "Message #0XYNTA has been delivered to 0 users. https://bnw.im/p/0XYNTA"}
Показать постhttps://bnw.im/api/show?message=ZG24XK
{"messages": [{"tags": ["simplified"], "text": "Все команды жуйкоинтерфейса теперь нечувствительны к регистру", "anoncomments": "", "date": 1342214311.7753761, "clubs": ["@", "bnw"], "replycount": 4, "user": "stiletto", "anonymous": "", "recommendations": [], "indexed": true, "id": "ZG24XK"}], "cache_public": true, "cache": 5, "ok": true, "format": "messages"}
Подписка на постhttps://bnw.im/api/subscriptions/add?message=ZG24XK&login=1234567890abcdef
{"ok": true, "desc": "Subscribed (4 replies)."}
Примеры ошибочных запросов Команда URL запроса Ответ
Несуществующая командаhttps://bnw.im/api/kkk
{"ok": false, "desc": "unknown command"}
Попытка рекомендации несуществующий постаhttps://bnw.im/api/recommend?message=ABC&login=1234567890abcdef
{"ok": false, "desc": "No such message."}
Не указан/неправильный loginkeyhttps://bnw.im/api/pm?user=stiletto&text=oh+hai
{"ok": false, "desc": "Only for registered users"}