topic Re: Swagger contract for SAS Viya REST APIs in Developers

Swagger contract for SAS Viya REST APIs

ElPrebsiDK — Mon, 17 May 2021 14:42:40 GMT

Hi SAS experts.

I am looking at calling SAS Viya REST APIs, and found the documentation containing a lot of code examples. Do you know if SAS expose a Swagger / OpenAPI contract file for that API?

https://go.documentation.sas.com/api/collections/edmcdc/v_003/docsets/edmresttut/content/edmresttut.pdf?locale=en#nameddest=p1sgknd1pv22hun1d029x7ogfxui

Re: Swagger contract for SAS Viya REST APIs

alexal — Mon, 17 May 2021 15:08:43 GMT

Please see ReDoc here: https://developer.sas.com/apis/rest/v3.5/DecisionManagement/

Re: Swagger contract for SAS Viya REST APIs

ElPrebsiDK — Mon, 17 May 2021 15:15:38 GMT

Thanks for the quick reply. I might be missing the obvious here? The link you provided looks like a GUI representation of the swagger yaml contract. But I can't seem to find the link to download the swagger file, so that I can build client code based on that in my development project.

Re: Swagger contract for SAS Viya REST APIs

alexal — Mon, 17 May 2021 15:21:32 GMT

You won't be able to download a swagger file, they weren't published on the external website. Please use the ReDoc link I've provided above to get information about the API.

Re: Swagger contract for SAS Viya REST APIs

ElPrebsiDK — Mon, 17 May 2021 19:35:36 GMT

Thanks Alexal.

If anybody else find the Swagger document for the Viya REST API, I am very interested. I am building a java client for the Viya REST API, so having the swagger document to generate code from will save me a lot of hours re-coding the info from the documentation.

Re: Swagger contract for SAS Viya REST APIs

joeFurbee — Mon, 17 May 2021 19:48:35 GMT

Hi @ElPrebsiDK,

The link @alexal provided is for the REST API doc. At this point that's all we have published externally.

We do have it on our roadmap to eventually publish the Swagger/OpenAPI file, but we aren't at the point where we can share them yet. If you have a specific use case for using it for integration purposes we'd be interested in understanding it. Please let me know.

Thanks,

Joe

Re: Swagger contract for SAS Viya REST APIs

ElPrebsiDK — Mon, 17 May 2021 20:24:58 GMT

Hi Joe.

Thanks for sharing your thoughts. Exposing REST APIs and the underlying contract kind of goes hand in hand. This is the first API I have stumbled upon, that restricts access to the contract. There is great tool support for generating client code in most flavors of most programming languages. And your html documentation seems to be generated based on a swagger document. So depending on how much of the API we need to integrate with, it might be worth while for me to build a reverse engineering tool to read your documentation and build the swagger myself. That way I am sure that nothing gets lost in the copy/paste/translate to java process.

How do other clients integrate with your APIs? Do they copy/paste snippets of code from the documentation?

Regards

Preben