Толковая статья про документирование API. Внешнего. Которое как продукт. Тратить такие же ресурсы на документирование внутреннего - дорого и во многом бесполезно! https://habr.com/ru/articles/722650/
Документирование внешних API как продукта
документированиеapiвнешний api