figshare
Browse

Software development

Download (1.12 MB)
journal contribution
posted on 2025-04-23, 05:50 authored by Ishwari JagtapIshwari Jagtap

In the modern software ecosystem, where services and systems are distributed and interconnected,

API documentation serves as the primary bridge between API providers and consumers. This

project aimed to explore, implement, and evaluate the creation of effective, usable, and interactive

documentation for RESTful APIs using industry-standard tools like Swagger (OpenAPI) and Postman.

Through structured design principles, consistent endpoint naming, comprehensive request/response

formatting, and real-time testing support, we have demonstrated how good documentation

enhances the developer experience, reduces integration time, and minimizes support overhead.

Key outcomes of the implementation and testing phase include:

 Significant improvement in onboarding speed and usability.

 Substantial reduction in support queries.

 Positive feedback on clarity, structure, and interactivity.

The documentation was evaluated both technically and through developer feedback, confirming that

interactive and developer-centric documentation is not just a value-add—it is essential for

scalable and maintainable API development.

History

Usage metrics

    Licence

    Exports

    RefWorks
    BibTeX
    Ref. manager
    Endnote
    DataCite
    NLM
    DC