DEV Community

Discussion on: The state of Laravel-based APIs - a personal research

niluspc profile image
Nil πŸŽ—

Yeah I totally agree documentation is a must, but I didn't want to be way too opinanted it because there wasn't a clear winner a couple of years ago. Swagger/OpenAPI is the clear winner for non GraphQL APIs now.

IMHO for PHP zircote/swagger-php is the best option to document using annotations in php doc-blocks without the need of writing the JSON yourself.

I'm still working on API development, currently under NodeJS and Java platforms, so I'm following all API posts and GraphQL posts here at :)

Thread Thread
igorsantos07 profile image
Igor Santos Author

Hahaha cool you ended up here :)

From past experience Swagger seemed really a PITA to get implemented, although being very powerful. Might be just a false impression, tho.

For my current case I ended up going with Postman. Started using it quickly to verify development, then wrote a test or two, then saw docs there... πŸ€·πŸΌβ€β™‚οΈ

Thanks for the input!