Announcements
This site is in read only until July 22 as we migrate to a new platform; refer to this community post for more details.
Get hands-on experience with 20+ free Google Cloud products and $300 in free credit for new customers.

Is SmartDocs susceptible to the same limitation that OpenAPI has with operation overloading?

Not applicable

Is SmartDocs susceptible to the same limitation that OpenAPI has with operation overloading? Refer to OpenAPI issue #146 for details.

For example, an API has two operations:

POST /to/some/collection

Content-Type: application/vnd.example.com.aaa+json

and

POST /to/some/collection

Content-Type: application/vnd.example.com.bbb+json

to overload the endpoint with different resource representations in the request body (the same would be for GET and Accept headers). Another example is the GitHub APIs which use application/vnd.github media types.

Open API 2.0 can't express this - one can only specify one model schema for the request body. Can SmartDocs do this? (We're just starting out with Apigee and have not gotten to the point of defining our API proxies or importing an Open API doc.). This might be a Developer Portal question...

thanks

0 3 151
3 REPLIES 3