http://forum.razved.info//index.php?t=6061 Отправка выдачи программы СайтСпутник в формате JSON на сервер на API, а также в папки сайта, по E-mail и в локальные папки компьютера. Реализация взаимодействия программы СайтСпутник со сторонними API. ru http://forum.razved.info//index.php?t=6061&p=57680#pp57680 http://forum.razved.info//index.php?t=6061&p=57680#pp57680 <ul><br /><b><u><font color="green"><font size="4">О реализации программного обеспечения на стороне сервера, API сервера, формат JSON</font></font></u></b><br /><br />В данном топике представлен один из вариантов взаимодействия программы SiteSputnik с API сайтов. <br />Эта работа полностью выполнена <b>Николаем Рыбаком</b> из г. Киева, Украина. <br />С ней можно ознакомиться подробнее на <a href="http://sitesputnik.ru/Help/I/JsonAPI.pdf" target=_blank>ссылке</a>. <br />Основное содержание этой ссылки, написанное Николаем, предназначено для программиста. Оно приведено ниже.<br /><br />Прежде, чем описать работу серверной части, необходимо знать, что делается программой SiteSputnik на стороне клиента, а именно:<br /><br />1) какая информация подготавливается к отправке на сервер;<br />2) метод и протокол отправки этой информации;<br />3) её детальную структуру и формат.<br /><br />На сервер программой SiteSputnik может быть отправлено содержание Рубрик или Чистого потока, отправка осуществляется по протоколу http/https методом POST в формате JSON, детальная структура которого такова:<br />{<br /> "route-api": "адрес отправки(собственно API)",<br /> "heading": "название проекта / рубрики",<br /> "date": "дата проведения мониторинга",<br /> "time": "время проведения мониторинга",<br /> "data": [<br /> {<br /> "title": "заголовок новости",<br /> "author": "автор",<br /> "description": "описание новости",<br /> "date": "дата новости",<br /> "time": "время новости",<br /> "rubrics": [<br /> {<br /> "head": "название рубрики, в которые попала новость"<br /> },<br /> ...<br /> ],<br /> "objects": [<br /> {<br /> "type": "тип объекта, размещенного в новости",<br /> "name": "его имя",<br /> "rank": "количество упоминаний"<br /> },<br /> ...<br /> ],<br /> "domain": "домен второго уровня",<br /> "url": "ссылка на новость"<br /> },<br /> ...<br /> ]<br />}<br /><br /><br /><b><u><font color="green"><font size="3">Общая схема взаимодействия выглядит так:</font></font></u></b><br /><br /><a href="http://sitesputnik.ru/Help/Pic/F/API_Json_01.jpg" target=_blank><img src="http://sitesputnik.ru/Help/Pic/F/API_Json_01.jpg" alt="" name="itag" border=none></a><br /><br />Как один из примеров возможной реализации этой схемы, представляется реализация сервера на платформе NodeJs / Express с записью получаемого json в базу данных MongoDB, вот ссылка на репозиторий с кодом – https<i>://</i>github.com/NickRbk/Simple-API. <br /><br />В папке <b>‘server’</b> находятся все файлы для запуска сервера. Папки <b>‘app’</b> и <b>‘config’</b> определяют настройки для запуска/работы БД и являются несущественными для описания общей схемы работы с SiteSputnik.<br /><br />Основной файл – <b>server.js</b>, в котором определен API, отвечающий за прием запросов методом POST.<br /><br />Это частный случай реализации серверной части сайта для приема данных с SiteSputnik. Все зависит от конкретной технологии, на которой работает конкретный сайт. В данном случае в параметр "route-api": СайтСпутник должен поместить следующее API: localhost:7777/api/news (здесь приведен адрес API для локально запущенного сервера).<br /></ul><br /><br /><br /><ul><b><u><font color="green"><font size="3">Информация о создании API такова: </font></font></u></b><br /><br /><br />// Создание API<br /> const apiRouter = express.Router();<br /> app.use('/api', apiRouter);<br /><br /><br /><br /> // Определяем адрес /api/news и назначаем ему метод POST<br />// То есть если Ваш сайт условно говоря https://test.com, то по адресу <br />// https://test.com/api/news можно отправлять запрос и этот адрес нужно<br />// указать для отправки в SiteSputnik<br /><br /> apiRouter.route('/news')<br /> .post( (req, res) =&gt; {<br /><br /> // через переменную req.body получаем доступ к json<br /> // и считываем данные, обращаясь к ключам json<br /><br /> const dataset = req.body['data'];<br /> <br /> const generalData = {<br /> routeApi: req.body['route-api'],<br /> heading: req.body['heading'],<br /> dateProject: req.body['date'],<br /> timeProject: req.body['time']<br /> };<br /><br /> <br /> // Тут для примера определена логика работы с БД,<br /> // функция для сохранения данных определена<br /> // по пути ‘./app/helpers/saveNews’<br /><br /> const saveNews = require('./app/helpers/saveNews');<br /> saveNews(dataset, generalData)<br /> .then(<br /> result =&gt; {<br /> res.json({ message: result }) // Ответ в случае успеха<br /> },<br /> error =&gt; {<br /> res.json({ message: error }) // Ответ в случае ошибки<br /> }<br /> );<br /> //___________________________________________________<br /> <br /> });<br /><br /></ul><br /> Алексей Мыльников Tue, 09 Jan 2018 10:57:21 +0300 http://forum.razved.info//index.php?t=6061&p=57679#pp57679 http://forum.razved.info//index.php?t=6061&p=57679#pp57679 <ul><br /><b><u><font color="green"><font size="3">Автоматическая конвертация в JSON</font></font></u></b><br /><br />Она осуществляется самостоятельно в процессе выполнения Проекта.<br />Примеры её прописки в программе СайтСпутник:<ul><br /><font color="blue">json:D:\DataBase\Json\02</font> – конвертация и отправка в локальную папку D:\DataBase\Json\02;<br /><font color="blue">json:mess-jsn@mail.com</font> – конвертация и отправка по указанному E-mail;<br /><font color="blue">json:http<i>://</i>sitename.ru/JSW</font> – конвертация и отправка в папку сайта;<br /><font color="blue">json:https<i>://</i>name.sitename.ru/com/api/news(api)</font> – конвертация и отправка на сервер на API, URL которого https:<i>//</i>name.sitename.ru/com/api/news.<br /></ul><br />Об отличии отправки в папку сайта от отправки на API сайта:<ul><br /><u>синтаксическое отличие</u> отправки в папку сайта от отправки на сервер на API заключается в том, что для последнего нужно приписать в конце адреса URL лексему: (api); <br /><u>семантическое отличие</u> – в первом случае происходит передача json-файла в папку сайта по протоколу ftp, а во втором – содержание файла отправляется по http/https протоколу методом POST и обрабатывается специальной программой на сервере, ждущей его.</ul><br /><br />Для Рубрики статической прописка осуществляется на её вкладке КП (смотрите картинку):<br /><br /> <a href="http://sitesputnik.ru/Help/Pic/F/Select_KP_Prefic_Static.jpg" target=_blank><img src="http://sitesputnik.ru/Help/Pic/F/Select_KP_Prefic_Static.jpg" alt="" name="itag" border=none></a><br /><br /><br />Для Рубрики динамической – в теле Проекта, после префикса КП (смотрите картинку):<br /><br /><a href="http://sitesputnik.ru/Help/Pic/F/Select_KP_Prefic_Dinamic.jpg" target=_blank><img src="http://sitesputnik.ru/Help/Pic/F/Select_KP_Prefic_Dinamic.jpg" alt="" name="itag" border=none></a><br /><br /><br />Для Чистых потоков – в Настройка – Параметры – Вкладка +Station (смотрире картинку):<br /><br /><a href="http://sitesputnik.ru/Help/Pic/F/ToJSON_Streams.jpg" target=_blank><img src="http://sitesputnik.ru/Help/Pic/F/ToJSON_Streams.jpg" alt="" name="itag" border=none></a><br /><br /><br />На картинке выше прописано отправить Чистый поток (напомню, что это все новости, собранные в Проекте) по четырём «направлениям»:<ul><br />• в локальную папку компьютера;<br />• в папку сайта;<br />• по E-mail;<br />• на API. </ul><br /><br />Правее знаков ^^ размещены комментарии.<br />Аналогично, любые Рубрики тоже можно отправлять по нескольким различным «направлениям». <br /> </ul><br />Продолжение следует ...<br /><br /> Алексей Мыльников Tue, 09 Jan 2018 10:27:29 +0300 http://forum.razved.info//index.php?t=6061&p=57678#pp57678 http://forum.razved.info//index.php?t=6061&p=57678#pp57678 <ul><b><u><font color="green"><font size="3">Ручная конвертация в JSON</font></font></u></b><br /><br />Становимся на Рубрику или Чистый поток (см. зелёную стрелочку на картинке ниже), нажимает на правую кнопку мышки и выбирает пункт меню, отмеченный на картинке красной стрелочкой:<br /><br /><a href="http://sitesputnik.ru/Help/Pic/F/ToJSON_arm.jpg" target=_blank><img src="http://sitesputnik.ru/Help/Pic/F/ToJSON_arm.jpg" alt="" name="itag" border=none></a><br /><br />В результате на рабочем столе получим файл с расширением json, содержащий результат конвертации. <br /><br />Пример такого файла на ссылке: <a href="http://sitesputnik.ru/Files/Json_Example.json" target=_blank>Json-файл</a>. </ul><br />Продолжение следует … Алексей Мыльников Tue, 09 Jan 2018 10:16:09 +0300 http://forum.razved.info//index.php?t=6061&p=57677#pp57677 http://forum.razved.info//index.php?t=6061&p=57677#pp57677 <ul>В данной теме рассматривается:<ul><br />• конвертация <b>выдачи</b> (содержания Рубрик и потоков) <a href="http://sitesputnik.ru/" target=_blank>программы СайтСпутник</a> в формат <b>JSON</b>; <br />• подготовка и отправка её в этом формате на сервер на API, <br />• в папки сайта, по E-mail и в локальные папки компьютера. <br /></ul><br />О работе программного обеспечения на стороне сервера, об API сервера, о формате JSON <br />можно прочитать в отдельной публикации <b>Николая Рыбака</b> из г. Киева, размещенной <br />на ссылке: <a href="http://sitesputnik.ru/Help/I/JsonAPI.pdf" target=_blank> О реализации взаимодействия программы SiteSputnik со сторонними API</a>. <br /></ul><br />Продолжение следует … Алексей Мыльников Tue, 09 Jan 2018 10:13:04 +0300