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 dev.to :)
Remote developer with 17+ years of experience. Mostly worked with PHP and with a passion for REST APIs and front-end interfaces, UX and DX - consequentially working also with React and Svelte.
Location
Rio de Janeiro, Brazil
Education
Universidade EstΓ‘cio de SΓ‘ / Dalhousie University
Work
Remote full-stack developer @ eHungry; past Toptal freelancer
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!
For further actions, you may consider blocking this person and/or reporting abuse
We're a place where coders share, stay up-to-date and grow their careers.
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 dev.to :)
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!