-
-
Notifications
You must be signed in to change notification settings - Fork 6.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
REST API documentation #2684
Comments
How about NelmioApiDocBundle(https://github.com/nelmio/NelmioApiDocBundle) ? |
The idea looks nice, similar to what swagger-php does. will check it out. |
I will be excited what yii 2 will come up for api docs. Looking forward to it. 👍 |
IMHO: swagger is the best practice in RF API services |
in my experience with swagger(that was like 5 months ago), the swagger UI does not support "resource" (out of the box) input classes and so you will have to annotate the body parameters individually to generate the input elements in the request form, i did modify the swagger UI itself and made it work, |
@fernandezekiel Yep! The same problem. Can you show your code? |
I am surprised, i was trying to decide between swagger and NelmioApiDocBundle to create an api. Doesn't NelmioApiDocBundle uses symfony components? is there a php conflict on that or makes it too slow? |
There are a few things that are missing here:
|
Update for OpenAPI Specification (fka Swagger RESTful API Documentation Specification) http://swagger.io/specification/
|
citing @nostop8 from #62 (comment):
|
@cebe I propose to review this extension https://packagist.org/packages/light/yii2-swagger
See these demos I'm trying it on a personal project |
Issue moved to yiisoft/yii-api#14 |
I'd like to create a dedicated issue for this to keep track of information and links for this topic.
Things taken from #303:
More:
The text was updated successfully, but these errors were encountered: