Open
Description
What is it?
For OpenAPI & REST
- Add CLI support to export role-specific OpenAPI to a JSON file based on config permissions
dab export-openapi -role: administrator -output: administrator.json
- Add config support to reference pre-configured OpenAPI documents
{
"OpenAPI-files": {
"administrator": "administrator.json",
}
...
}
- Add
/OpenAPI
support to fetch role-based document.
https://localhost/OpenAPI?role=administrator
perhaps auto-switch with header information.
For GraphQL
- Add CLI support to export role-specific GraphQL Schema to a JSON file based on config permissions
dab export-graphql -role: administrator -output: administrator.json
- Add config support to reference pre-configured GraphQL Schema documents
{
"GraphQL-schema-files": {
"administrator": "administrator.json",
}
...
}
- Add /graphql support to use pre-configured Schemas.
Discussion
- Preconfigured documents will reduce startup time
- Preconfigured documents will help accurate documentation (from OpenAPI)
- Role-specific docs/schemas help prevent confusion with consumers seeing inaccessible items.
- Role-specific docs/schemas help prevent metadata from "leaking" to consumers.