Autorest Swagger c# client

API and Webhooks
1

Description
We are having a hard time generating a C# client based on your swagger json using Autorest. Autorest is reporting the same errors as https://editor.swagger.io/ regarding additionalProperty: oneOf

Error
Structural error at paths./accounts/{accountId}/settings.get.responses.200.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 3415
Structural error at paths./accounts/{accountId}/settings.patch.parameters.1.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 4071
Structural error at paths./accounts/{accountId}/plans/addons.post.parameters.1.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 6038
Structural error at paths./users/{userId}/settings.get.responses.200.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 23069
Structural error at paths./users/{userId}/settings.patch.parameters.1.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 23718
Structural error at paths./groups/{groupId}/settings.get.responses.200.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 32347
Structural error at paths./groups/{groupId}/settings.patch.parameters.1.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 32915
Structural error at paths./rooms/account_settings.get.responses.200.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 35754
Structural error at paths./rooms/account_settings.patch.parameters.0.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 36045
Structural error at paths./rooms/locations/{locationId}/settings.get.responses.200.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 36686
Structural error at paths./rooms/locations/{locationId}/settings.patch.parameters.0.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 36995
Structural error at paths./rooms/{roomId}/settings.get.responses.200.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 37600
Structural error at paths./rooms/{roomId}/settings.patch.parameters.1.schema
should NOT have additional properties
additionalProperty: oneOf
Jump to line 37907
Structural error at definitions.AccountSettingsAuthenticationUpdate
should NOT have additional properties
additionalProperty: oneOf
Jump to line 56358
Structural error at definitions.AccountSettingsAuthentication
should NOT have additional properties
additionalProperty: oneOf
Jump to line 56502
Structural error at definitions.GroupUserSettingsAuthenticationUpdate
should NOT have additional properties
additionalProperty: oneOf
Jump to line 56598
Structural error at definitions.GroupUserSettingsAuthentication
should NOT have additional properties
additionalProperty: oneOf
Jump to line 56699

How To Reproduce (If applicable)

  1. Upload swagger json to https://editor.swagger.io/
  2. See validation errors
2

Hey @kiesel.dennis, thanks for posting and using Zoom!

You will have to convert the JSON to Open API 3 and then it will work.

Screen Shot 2020-01-23 at 10.34.56 AM

Thanks,
Tommy

3

It doesn’t seem like we will be able to auto generate a c# client, even using the converted swagger. Autorest throws errors about the structure and generating the client using Swagger Editor created a client that is not buildable, with many errors.

4

Hey @kiesel.dennis,

We also have these, but they in beta and not up to date with our latest releases.

https://drive.google.com/drive/folders/1JfxC7Ybla3wc0xTpPAXMvO_g5n6m_TZM?usp=sharing

In the meantime, we are working to improve our client libraries.

Thanks,
Tommy

5

@tommy,

Thanks for your help. I think we are going to manually create a client library. The beta client fails to build as well.

1 Like
6

Thanks for letting me know @kiesel.dennis,

We will improve our Client Libraries.

Thanks,
Tommy

7

With a rough conversion pass through https://www.apimatic.io/ and a little massaging I was able to generate a working configuration for autorest.

https://filebin.ca/5GTeHw3txVpX/ZoomAPI.oas2.json-Swagger20.json

Due to some design eccentricities in many api endpoints there is a pretty heavy load of object duplication. As long as you don’t mind binding to objects named things like body18 due to missing descriptions this client looks pretty functional.

zoom: Any thoughts as to a timeline on updating your specs to be fully compliant?

1 Like
8

Hey @samf, thanks for providing a working configuration! :slight_smile:

Currently no timeline, but we are doing our best to get a long term solution soon.

Thanks,
Tommy

9

Thanks samf, this is json is much better

1 Like
10

Glad you found samf’s JSON helpful! :slight_smile:

-Tommy