Show HN: APIBoard, Interactive API Documentation with JS-Powered Workflows

by revetkn • 11 years ago

15 9 11 years ago

revetkn4• 11 years ago

The basic idea is we wanted a hosted Postman which allows you to wire your endpoints together "lego-style" into workflows (step 1 is authenticate, step 2 is fetch a list of users, step 3 is update the first user in the list). You can then shoot someone a URL and they can hit the "play" button and the API calls execute before their eyes. Some other notable features we've added are team support, versioning, and dependency tracking.

The drawback of most hosted services like this is you can't see things on private networks, like localhost or a corporate intranet. We have an OS X native app to circumvent this and a Windows version is coming soon.

We'll try to answer any questions you might have, thanks for checking it out!

ie• 11 years ago

I am interested in the concept, however I feel like the mix of GUI and code editors is too complex. I'd rather see it all in a code editor without the GUI.

revetkn4• 11 years ago

Thanks for your feedback - getting the UI right is one of the big challenges for us given the complexity of the system. We've been experimenting internally with different approaches, one of them being a per-user preference "raw" mode that works as you described.

navd• 11 years ago

The landing page is so messed up on safari mobile that I can't even read it.

revetkn4• 11 years ago

Whoops, sorry, our fault - should be fixed now. The viewport meta tag was unintentionally locking scaling and initial zoom level.

Nadya2• 11 years ago

I doubt that it was unintentional.

It's an old fix to what I perceive as a non-problem [0]. When a user turns their iPhone to view it on Landscape - the site won't resize without that viewport meta tag being there.

Not sure if it's been fixed. Even if it hasn't, I question the amount of people who browse on their phones in Landscape.

[0] http://webdesignerwall.com/tutorials/iphone-safari-viewport-...

I'm running under the assumption that you might not be the dev and that the dev may have added it there intentionally to fix the landscape bug. This post has the wrong tone without it being read more explanatory, so I felt this clarification necessary.

pcimino• 11 years ago

I've been playing with this on and off for a few weeks. My shop has their own REST development and review process. So I've been using it as an educational tool for devs new to REST, fits the bill better than swagger or postman.

Show HN: APIBoard, Interactive API Documentation with JS-Powered Workflows

Related Stories