Discussions
Which Server URL it will pick from open api spec file ?
In open api spec file, we have a servers section under which we define URL's and their description,
As of now i can see it always picks the first URL which is defined, what if i define 4 URL's under it and i want that it should pick 2nd URL.
Highlight New Content
I was wondering if there was a way we can highlight new content on the Docs pages. Adding a new tag before or after the page name would be ideal.
How to upload new api spec file under particular defined tag
I have a spec file with title "NRT" which have 3 tags for locale, naming -> "US", "MEXICO", "CANADA".
Problem with die Authentification
Hello, I want to use the API via Ostrom. I'm currently testing the login using the test scripts on the Ostrom website. Unfortunately the registration fails (Code 401) because it is not clear to me which "client_credentials" have to be specified in addition to the registration. What do i have to do?
Polymorphism support with allOf
Hello, I'm trying to use oneOf
and allOf
in my specification to support polymorphism in readme. Experimenting using example in here, my OAS looks like this:
Timing of bi-directional sync for Enterprise customers?
Hello. When will bi-directional sync be available for Enterprise customers?
How to write curl -x request in open api spec so that readme.io interprets it correctly?
How to write curl -x request in open api spec so that readme.io interprets it correctly? For now it is not interpreted correctly in readme.io for curl request without -x, it is working fine
How to publish only v1 folders under some other folders
Folder structure :
Blank content on the Reusable Contents
Is there anyone facing your reusable contents blanked too?
OpenAPI Reusable Responses with Examples loading the first time but disappearing when I click another endpoint
I'm using shared Responses definitions (with a shared ApiError schema) for error responses. I added examples on all of them, and as per OpenAPI spec, the "examples" under "responses.content.application/json" should override whatever was set as examples on the schema. (See: https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#media-type-object)