개인적으로 생각하는 API문서는 Postman 에서 무료로 제공하는 Document를 활용해 보는것을 추천드립니다.
대부분 API 문서는 초기 작성 후 변경 사항이 있을 때 유지보수가 잘 안된다는 단점이 있습니다. 개발시에 API 테스트도 해야되고, 개발 후에 문서 업데이트도 해야되는 상황이 많을 텐데요, Postman 에서는 api collection 이라는 것을 제공하고 있고, 개발 시 api를 쉽게 테스트할 수 있는 기능을 제공하고 있습니다. 테스트 완료 후, 해당 콜렉션의 Document를 publish 하고, 해당 링크를 타팀에 공유만하면, 별도로 문서 업데이트 작업없이 최신 반영된 정보를 공유할 수 있어서 좋다고 생각합니다.