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
Add API documentation #381
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looking good. Have a single recommendation re: the README change. Love to see this happening! Thanks for taking this on.
README.md
Outdated
This Ruby application provides a REST API for DOR Services. [View the REST API documentation](https://consul.stanford.edu/display/chimera/REST+mappings+for+dor-services+gem). | ||
|
||
This Ruby application provides a REST API for DOR Services. | ||
There is a OAS 3.0 spec that documents the API in [openapi.json]. If you clone this repo, you |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can you unpack "OAS" and/or link somewhere relevant? (Yeah, I know, OpenAPI.)
|
||
|
||
|
||
## Was the API documentation (openapi.json) updated? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
👍
</style> | ||
</head> | ||
<body> | ||
<redoc spec-url='https://raw.githubusercontent.com/sul-dlss/dor-services-app/master/openapi.json'></redoc> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
radical
This has all of the endpoints, but doesn't yet have all the parameters and responses.
This has all of the endpoints, but doesn't yet have all the parameters and responses.