search

MicrosoftDocs / navdevitpro-content-pr

Content for the devitpro release for on-prem & PaaS
Creative Commons Attribution 4.0 International
6 stars 35 forks source link

OpenAPI specifiocation download not working #2139

Open kine opened 3 years ago

kine commented 3 years ago

The link to download OpenAPI specification for API v2 is not working. Returning Error 404.

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

edupont04 commented 3 years ago

Hello Kamil,

I suspect a temporary glitch since the link works just fine for me just now. Can you try again?

kine commented 3 years ago

Hi Eva, no, still Error 404. The download leads to https://docs.microsoft.com/en-us/dynamics-nav/api-reference/v2.0/contracts/BCOAS1.0.yaml

Another thing is that it is page for API v2 but in the text is the link marked as v1.0. File name is 1.0 too. Isn't it some mixture of versions?

Because https://docs.microsoft.com/en-us/dynamics-nav/api-reference/v1.0/contracts/BCOAS1.0.yaml works and it give me v1.0. I have tried even https://docs.microsoft.com/en-us/dynamics-nav/api-reference/v2.0/contracts/BCOAS2.0.yaml but not exists too.

edupont04 commented 3 years ago

Yes, you're right - there isn't a YAML file for v2.0. I don't know why, and the people who do are on vacation this week (school break here in Denmark). Until they are back, I'll update the link to make it clear that it's for v1.0.

henrikwh commented 3 years ago

Hi @kine We dont have an OpenAPI spec for V2.0 of the APIs. I suggest that you try an use this project from GitHub to generate OpenAPI spec from OData metadata. https://github.com/microsoft/OpenAPI.NET.OData

That should get you started on an OpenAPI spec.