Well done Box API team! :)
This is a new example on developer experience. Stripe is taking a similar path with integrating Runkit (https://runkit.com) examples in their API documentation.
After static documentation came interactive documentation generated by API description format like Swagger or RAML.
We also had companies like Readme.io trying to provide a "standard" layout for API documentation.
I think now it's the time for interactive/dynamic examples like this one.
But I really wonder how this tool could be maintain in the back, is it easy to add a new feature/endpoint?
Are you using anything like Swagger?
Plan to opensource your tool?
@picsoung hey Nicolas- great questions. We're looking into a swagger spec now and have a really good relationship with Readme.io, so perhaps we can work with them by defining a standard for API Navigators. As I mentioned in the comment above, this was an internal tool developed by a few folks at Box that we decided to open up. The feedback has been really positive so far!
Report
@picsoung Not *that* related (sadly :) ) but I think that what you mention is what we're trying to accomplish at CodePicnic (https://codepicnic.com/docs) to move from static documentation towards real code users can actually work with, play around (and obviously, mess up!).
Hey Product Hunters - we're really excited to share this new tool!
Box’s API provides a number of different capabilities to handle files in an application. From uploading a file to displaying a file to searching for files, different endpoints of our API can be chained together to power a file component of any application. But sometimes, it can be hard to understand how these different endpoints fit together and how they might help you in an application you’re building.
Today, we're excited to introduce a new tool for developers called API Navigator. API Navigator is a web application that allows you to explore how Box Platform can be integrated into an application using our APIs.
You can read an introduction to API Navigator here: https://docs.box.com/v2.0/blog/i...
We've also made a ton of updates to our developer experience and you can read more about this here: https://blog.box.com/blog/box-de...
Let me know if you have any questions!
Report
@_mikeschwartz top level dev-experience
Just wonder if you have a dedicated team for that product
Keep it up!
@matveyich we do! We have a whole team that solely focuses on developer tools. API Navigator was built by a team at Box who builds demos for customers. We've now productized this and will continue to look at how to improve it - maybe even open source it.
A lot of folks have been mentioning the move from static to interactive documentation. We recently enabled a bunch of new features to our docs, created by our documentation platform, Readme.io. If you haven't heard of Readme, check them out. You can also explore our new docs site here: https://docs.box.com
Report
Nice. Only thing is why would a documentation require access to my Google Account ? :)
Report
@austinringer Actually I was thinking just being able to check out/playing with the docs without even needing to register/login. M I missing something or why is login in required ?
@ted_blosser thanks for the comment, Ted! You should check out our docs, too. The folks at Readme.io have introduced a ton of new features! Thanks for setting us up with them!
BnbIcons
Adobe Spark Post
Adobe Spark Post
Adobe Spark Post
Adobe Spark Post
WorkRamp
Adobe Spark Post
WorkRamp
API Fortress
Box API Navigator
MailKing by cloudHQ
Adobe Spark Post