APIs-guru / openapi-directory

🌐 Wikipedia for Web APIs. Directory of REST API definitions in OpenAPI 2.0/3.x format
https://apis.guru/
Creative Commons Zero v1.0 Universal
3.78k stars 568 forks source link

Add "VTex" API #122

Closed sanchojaf closed 1 year ago

sanchojaf commented 7 years ago

Format: OpenAPI 3.0 Official: YES Url: https://github.com/vtex/openapi-schemas Name: VTex

IvanGoncharov commented 7 years ago

@sanchojaf Problem is this API documented in Spanish, am I correct? Before adding it I need to think of so mechanism to support API documented not in English. Will think about it this week.

sanchojaf commented 7 years ago

Hi @IvanGoncharov is Portuguese

MikeRalphson commented 7 years ago

@IvanGoncharov could you give me your thoughts on the issues with non-English-language API definitions? What might need changing/translating?

IvanGoncharov commented 7 years ago

What might need changing/translating?

@MikeRalphson At the minimum non-English specs should be marked with the language used ( for e.g. x-description-language ), so you would be able to filter spec based on language. You can use this spec: https://en.wikipedia.org/wiki/ISO_639-1

MikeRalphson commented 7 years ago

@sanchojaf Vtex seem to have moved over to using Postman collections to document their APIs. Can you confirm?

If so it would be dependent on this issue

MikeRalphson commented 4 years ago

VTEX seem to have moved (back) to OpenAPI 3.0 - https://github.com/vtex/openapi-schemas

MikeRalphson commented 1 year ago

API added, many thanks for the contribution! The API will be live on the website after the next CI run.