Repository navigation
Replies: 5 comments 1 reply
|
Documentation and Swagger/OpenAPI specifications are a critical component of a REST API. This section is missing even though it's probably one of the most imporant sections. |
|
It states a preview API should follow: It doesn't mention what preview_id is. However, preview should be a function of the version and not add to the path. So it should be: I.e. |
|
https://github.com/keycloak/keycloak-community/blob/master/design/rest-api-guideline.md#pagination should have a pagination or last link so it's possible to know how many pages there are. Or, should pagination include the total count? |
|
Total count for users, clients are often required not just for pagination. but keeping a track of the limitations |
|
https://github.com/keycloak/keycloak-community/blob/master/design/rest-api-guideline.md#filtering
|
|
Adding resourceVersion for https://github.com/keycloak/keycloak-community/blob/master/design/rest-api-guideline.md#concurrency-control-and-concurrency |
Uh oh!
There was an error while loading. Please reload this page.
https://github.com/keycloak/keycloak-community/blob/master/design/rest-api-guideline.md
All reactions