welcome: please sign in

The following 156 words could not be found in the dictionary of 0 words and are highlighted below:
1234567890abcdef   add   anoncomments   anonymous   api   been   blacklist   Bn   bnw   cache   clubs   command   commands   comment   date   del   delete   delivered   desc   E0   false   feed   for   format   G24   hai   has   https   id   im   indexed   interface   kkk   login   loginkey   message   Message   messages   No   off   oh   ok   on   Only   org   passlogin   pm   post   public   recommend   recommendations   redeye   register   registered   replies   replycount   ru   search   show   simplified   stat   stiletto   Subscribed   subscriptions   such   tags   text   to   today   true   unknown   update   user   userlist   users   vcard   wiki   wikipedia   авторизации   аргументов   боту   будет   версии   Взаимодействие   виде   Все   выбор   выдаются   выполнения   длинные   дублируют   Если   жуйкоинтерфейса   зависимости   запрос   запроса   запросов   значения   или   Интерфейс   интерфейса   используются   команд   команда   Команда   команду   команды   который   красноглазого   можно   на   Не   необходимо   неправильный   Несуществующая   несуществующий   неуспешен   нечувствительны   от   Ответ   ответе   ответы   отправив   ошибки   ошибочных   параметр   передать   Подписка   Показать   получить   пользователя   помощью   Попытка   пост   поста   Примеры   принимает   причину   происходит   пук   равный   регистру   рекомендации   сервером   содержать   Создание   Список   теперь   то   только   требует   уау   указан   успешности   Функции   функция  

Clear message
location: u / Stiletto / BnW / API

API

Функции 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."}

Не указан/неправильный loginkey

https://bnw.im/api/pm?user=stiletto&text=oh+hai

{"ok": false, "desc": "Only for registered users"}

u/Stiletto/BnW/API (last edited 2014-06-05 11:52:47 by Кур_Кумит)