Whether you’re a startup developing your first API or an established player in the API economy, the truth is becoming steadily more apparent; providing quality API documentation is vital to the success of an API initiative. API documentation is an important part of the product offering, delivering affordances to the developer community to help them understand exactly what an API offers and how to use it. Read more
Posts Tagged: Apiary
Software development these days is about iterating fast, and releasing often. In the 10 years since Martin Fowler wrote his original paper, continuous integration has become a cornerstone of the software development process. It is a fundamental part of Agile development (being one of the core tenants of Extreme Programming) and has helped to spawn organizational change with the creation of the DevOps approach to application development. Read more
Perhaps one of the most important aspects of API development is source control. Proper implementation of source control can lead to more efficient, effective development, with fewer bugs, dependency conflicts, and operational errors.
One of the most popular forms of source control in the modern development environment is GitHub. Read more
- How do you decide which endpoints you’re going to expose with your API?
- How do you create all the documentation that developers will use to interact with your API?
- What is the best way to verify that your API is working as specified by the documentation, and in keeping with the developer’s expectations?