TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Don't depend on someone else writing your API Spec

5 pointsby allthingsapialmost 9 years ago

2 comments

krsyoungalmost 9 years ago
Definitely there are many benefits to having API specifications available (SDK generation, testing, etc.) especially if they can come from the providers as an alternate from human readable documentation. Seems like the challenges presented above are due a 3rd party trying to find / produce swagger where none existed (a truly heroic effort). Goes back to providers publishing some type of API specification just like websites provide sitemap.xml so APIs Guru can move to higher value projects!
puffinmuffinalmost 9 years ago
Great article! :D Truly praiseworthy!