-
|
Hi, Are there any best practices or recommendations on the maximum number of endpoints in an API? Also, the size of the API becomes harder to maintain with each feature or endpoint. We need more documentation of API other than API Specification itself to understand and update it in the right way. Do you have any ideas or suggestions? Thanks, |
Beta Was this translation helpful? Give feedback.
Replies: 1 comment
-
|
No, we don't provide best practices for API designers. The OpenAPI Specification (OAS) is intended to allow folks to describe what they have (including inheriting APIs of arguably questionable design). The scalability of your tools is probably more of a concern. The OAS does not care how many endpoints you add, so I am going to close this as out-of-scope for us (but it is certainly a real and valid maintainability concern! Just not one we can solve). |
Beta Was this translation helpful? Give feedback.
No, we don't provide best practices for API designers. The OpenAPI Specification (OAS) is intended to allow folks to describe what they have (including inheriting APIs of arguably questionable design). The scalability of your tools is probably more of a concern. The OAS does not care how many endpoints you add, so I am going to close this as out-of-scope for us (but it is certainly a real and valid maintainability concern! Just not one we can solve).