
These developers will ask me "where's the doc ?" because they cannot guess how the API works. The API is built and tested, now I would like other developers to use it (for example to build a cool JS frontend). Nothing unusual here, Symfony developers will recognize something very standard: The API was built using Symfony 3.1, a mysql database handled with DoctrineORM and the library FOSRestBundle. The DELETE endpoint is a soft delete: the record is marked as deleted but is not truly deleted.
#Swagger editor docs movie
DELETE /v1/movie/ to delete an existing movie from the database.POST /v1/movie to register a new movie into the database.GET /v1/movies to fetch movies from the database, which accepts some parameters: dir (sorting direction, "asc" or "desc"), page (for pagination) and sort (to select which field to sort on).I use in this example a simple Symfony REST API to handle a Movies database. I split the post in 2 parts because it was quite long to read. an accurate HTML documentation using Swagger.This post will show you how you can combine some tools together in order to build, for a php API: I wanted to share some cool tool combinations tricks I have learned this year. Automated API documentation systems, API client SDKs, REST user-friendly clients. Īnd because they are widely used in modern web apps, we can see that the tooling for APIs has upgraded a lot too. They are now everywhere : they fuel Javascript single-app pages with data, they allow developers to manage an elasticsearch instance, they are used to decouple monolithic applications into micro-services.
