Discussions

Ask a Question
Back to all

Issue in the OpenAPI Yaml

Hi there,

Not really a question, rather a hint, as of now, I don't know how else to put that forward:

we started to explore the API, and used Microsoft Kiota to generate a C# Client from your OpenAPI description.

(I also tried Microsoft OpenAPI, but that didn't work out for a completely different reason). However, I think there is an unfortunate mistake:


Excerpt from your openapi.yaml:

4589 schemas:
4590 Account:
4591 type: object
4592 description: Represents an account as an object
4593 properties:
4594 id:
4595 type: number <== This should be integer, not number
4596 example: 12345678
4597 description: The id of the account at B2brouter
4598 readOnly: true


As a result, most generators, - not just the Microsoft ones, not just the ones for C#, but for every language that knows the difference between floating point numbers and integers - would implement the ID as data type double or float, not as an integer or a string, as would be appropriate.

Of course, the obvious workaround for the time being would be to locally fix that. But it would definitely be better, if it was fixed in your original instead.

Greetings