Where did you get these OAS specs?

[klaude]

Where did you get these OAS specs?

[kraney]

Ah, I was hoping nobody would get mad over that. Good to know I didn't expose any secret sauce - it didn't seem likely given that the doc is open to the public, but companies can be picky sometimes.

You are correct, I got the OAS specs from the API reference. Just looking at the interactive docs, I reasoned that it had to be generated from an OAS spec. No way that was all done by hand, it just wouldn't make any sense. So I thought I might find them in there somewhere. I already knew from prior work if I had the spec, I could generate a client using openapi-generator.

...so I opened the Chrome developer console, and just searched for "oas" within the source. I found there is a script tag named "readme-data-oasFiles" that has the OAS JSON directly, and another named "readme-data-oasUrls" that has a web link I presumed would be a link to the OAS - and it was.

So then I used curl to pull them down, and piped them through jq so they were a little more readable. And there you have it. I figured it couldn't be too subversive to do so, since it was right there in the doc, just not in a place that's normally displayed.

[kraney]

By the way, I've been using StackPath's container service in support of a home / side project - https://tempoprimo.rehearsal.network/ It's been a great service so far!

[kraney]

...since no one's asking me to take down the OAS specs, I'll go ahead and close this as an issue...

[klaude]

Hey that's awesome! Do you mind if I show your side project around the office? We like seeing how folks use the platform. Nice finding our OAS specs like that. Eventually we'll have an official page so you won't have to sneak around the developer consoles. Please reach out to our support team if there's anything we can do for you!

[kraney]

Not at all, please do. I've reached the point where I'm trying to spread the word and get people interested in using it.

I've reached out to support a couple of times now and gotten great responses, although all they've needed to do so far is help me realize my own mistakes. :)

[klaude]

Hey it's all good. Thanks for the kind words! I'm glad we could help. Please please reach out if you need anything.