ReSQL.ru
     
powered by simpleCommunicator - 2.0.59     © 2025 Programmizd 02
Мобильная версия    Контакт    Правила    FAQ    Помощь
Целевая тема:
Создать новую тему:
Автор:
Закрыть
Цитировать
Доб. в избранное | Игнор. тему | Прикреп. тему | Пометить прочит. / непрочит. | Фильтр
Форумы / Разработка информационных систем [игнор отключен] [закрыт для гостей] / Как вы храните список ваших серверных REST API ?
9 сообщений из 9, страница 1 из 1
Как вы храните список ваших серверных REST API ?
    #39815795
Фотография u78
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
u78
Участник
У нас большая самописная система.

Фронт Javascript
Бэк REST API, C# + MS Sql
Протокол передачи JSON

Вырос большой зоопарк разных запросов с разными параметрами, для разных нужд.
Хочу описать все наши точки доступа к серверу: точка доступа, входные параметры, выходные и описание.

Вопрос - как это оформить, самое простое и быстрое в текстовом документе с поиском, но может есть какие то более удобные инструменты?
...
Рейтинг: 0 / 0
21.05.2019, 13:49
| Ответить | Цитировать | Написать  
Как вы храните список ваших серверных REST API ?
    #39815805
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Petro123
Участник
u78,
А что вы там ищите и будете искать?
...
Рейтинг: 0 / 0
21.05.2019, 13:57
| Ответить | Цитировать | Написать  
Как вы храните список ваших серверных REST API ?
    #39815885
Фотография u78
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
u78
Участник
Petro123u78,
А что вы там ищите и будете искать?

Буду искать API по названию и по описанию.
Например нужны мне данные в каком то разрезе - открываю список API и смотрю там, ищу по ключевым словам или по названию таблицы с нужными данными.
...
Рейтинг: 0 / 0
21.05.2019, 15:55
| Ответить | Цитировать | Написать  
Как вы храните список ваших серверных REST API ?
    #39815957
Фотография Petro123
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Petro123
Участник
u78,
Должность какая?
Это API для разработчиков, а не менеджеров. Данные там искать.
...
Рейтинг: 0 / 0
21.05.2019, 17:37
| Ответить | Цитировать | Написать  
Как вы храните список ваших серверных REST API ?
    #39816215
Serguei
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Serguei
Участник
u78Вопрос - как это оформить, самое простое и быстрое в текстовом документе с поиском, но может есть какие то более удобные инструменты?

Почитайте на хабре статью "3 лучших инструмента для описания RESTful API".
...
Рейтинг: 0 / 0
22.05.2019, 10:10
| Ответить | Цитировать | Написать  
Как вы храните список ваших серверных REST API ?
    #39817571
Дмитрий Мух
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
Дмитрий Мух
Участник
u78,

мы используем Swagger.

Swagger is a language-agnostic specification for describing REST APIs.

https://docs.microsoft.com/en-US/aspnet/core/tutorials/web-api-help-pages-using-swagger
...
Рейтинг: 0 / 0
24.05.2019, 10:49
| Ответить | Цитировать | Написать  
Как вы храните список ваших серверных REST API ?
    #39817966
Фотография u78
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
u78
Участник
Дмитрий Мухu78,

мы используем Swagger.

Swagger is a language-agnostic specification for describing REST APIs.

https://docs.microsoft.com/en-US/aspnet/core/tutorials/web-api-help-pages-using-swagger

спасибо, интересная штучка
...
Рейтинг: 0 / 0
24.05.2019, 18:41
| Ответить | Цитировать | Написать  
Как вы храните список ваших серверных REST API ?
    #39818312
Фотография hVostt
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
hVostt
Участник
u78,

redoc, open api (swagger)
...
Рейтинг: 0 / 0
26.05.2019, 04:36
| Ответить | Цитировать | Написать  
Как вы храните список ваших серверных REST API ?
    #39818461
fkthat
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
fkthat
Участник
Гугли Swagger.
...
Рейтинг: 0 / 0
26.05.2019, 20:03
| Ответить | Цитировать | Написать  
9 сообщений из 9, страница 1 из 1
Форумы / Разработка информационных систем [игнор отключен] [закрыт для гостей] / Как вы храните список ваших серверных REST API ?
Найденые пользователи ...
Разблокировать пользователей ...
Читали тему (0):
Читали форум (0):
Пользователи онлайн (0):
Польз. соглашение
NoSQL.ru       Новости, Чат       Фотоальбом: Участники, Встречи
Закрыть
start [/forum/topic.php?fid=33&gotonew=1&tid=1547156]:
 0ms
get settings:
 9ms
get forum list:
 12ms
check forum access:
 4ms
check topic access:
 4ms
track hit:
 40ms
get topic data:
 10ms
get first new msg:
 7ms
get forum data:
 2ms
get page messages:
 49ms
get tp. blocked users:
 2ms
others: 12ms
total:  151ms
созд. / загр.: 151ms
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]