Какие рамки используют Google, Microsoft, FB для документирования своих REST API

Question

Я использую Swagger для документации REST API, которая построена с использованием Spring Framework.Я ищу лучшие альтернативы, где мне не нужно снова и снова определять сложные ресурсы в каждом API.

Как Google имеет четко определенную документацию Google Doc .Какие рамки используют для этого ведущие ИТ-компании.

Answer 1

Ну, я посоветовал двум из этих компаний использовать OPTIONS.

Данные OPTIONS могут кэшироваться во время выполнения, давая индивидуальный APIDOC для каждой роли / AUTHORITY.

Таким образом, USER не увидитADMIN конечных точек, и вы можете создать динамический APIDOC.