Доброе время суток!
Есть бибилиотека из http/https и wss/ws запросов (на node.js)
Делаю для своего сервиса открытый доступ к данным.
Доступ есть только на получение данных, т.е. на get запросы.
Как лучше всего их оформить для внешнего пользователя?
У меня в голове есть несколько вещей:
1) Сделать библиотеку на js, в ней уже собрать все методы для получения нужных данных, как к примеру библиотека у
slack. И такую же аналогично и для php, python, go, java (на других языках к сожалению не работал)
2) Есть пример грамотно оформленной документации, и можно ли как то автоматически ее выгружать, на ум приходит только swagger, но мне способ его оформления не оч нравится, может кто то может посоветовать что по лучше?
3) За арихитектурный подход взял Rest, я понимаю, это вопрос холиварный, но тут вопрос в том, смогу ли я, если перейду на graphql, его автоматически документировать, как в swagger?
И последний вопрос - есть у кого то примеры ?
У какого сервиса самое приятно API с которым вы когда-либо работали?
