linode-api-docs icon indicating copy to clipboard operation
linode-api-docs copied to clipboard

Published 20 hours ago • verified publisher icon linode

Specification Errors Prevent Parsing

Open MarianSWA opened this issue 3 years ago • 0 comments

Hi, I'm trying to use this specification (as well as the one on the website) and there are errors in it. This prevents it from being parsed by various tools.

  • example: {'survey_link': https://alinktothesurvey.com'} - missing single quote (after fixing manually I get the next errors)
  • in https://editor.swagger.io/ I get errors at lines 4432 and 18389, at the pattern property (after fixing manually I get the next errors)
  • When parsing it in .Net (https://github.com/microsoft/OpenAPI.NET) I get the following errors:
    • The reference string '/components/schemas/EntityTransfer/properties/entities' has invalid format.
    • The reference string '/components/schemas/PaginationEnvelope/properties/page' has invalid format.
    • The reference string '/components/schemas/PaginationEnvelope/properties/pages' has invalid format.
    • The reference string '/components/schemas/PaginationEnvelope/properties/results' has invalid format.

I just tried the same tools with the digital ocean yaml specification and it's parsed just fine.

It's a shame that I can't use this specification in .net. Could you fix the errors?

Thank you!

MarianSWA avatar May 05 '22 08:05 MarianSWA