Skip to content
This repository has been archived by the owner on Feb 5, 2020. It is now read-only.

Add Gitter API WADL file #43

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

abhisekp
Copy link
Contributor

@abhisekp abhisekp commented Sep 3, 2016

👉 https://apigee.com/abhisekp/embed/console/gitter

I hope this is as verbose as possible.
Please comment any remaining API endpoints which are missing.

@MadLittleMods MadLittleMods changed the title feat(gitter-api): Add gitter api WADL file Add Gitter API WADL file Sep 5, 2016
@suprememoocow
Copy link
Member

@abhisekp thanks for this. This must've taken you a lot of time.

We have talked about publishing something like this in the past. Can I ask why you chose WADL? We have been considering Swagger 2.0 (in yaml). It is fairly easy to convert between competing formats, but I'm interested in why you chose WADL.

@abhisekp
Copy link
Contributor Author

abhisekp commented Sep 6, 2016

@suprememoocow I had never worked with either of the specs before or Apigee console to go.
It all began with my feature request in gitter 👉 https://gitter.im/gitterHQ/api?at=57c570626bf6aa805ece93b4.

I read the Apigee docs and it seemed like they only support WADL file format. To my dismay, I didn't find any WADL file generators too. 😒 So I wrote everything manually with help from @MadLittleMods

But if you already have everything documented in Swagger 2.0 format, which can be converted to WADL file format for uploading to Apigee or use any other such tech, then it's alright. 👍

Just need something like the Apigee Console to Go thing embedded in gitter api docs. 😄

@abhisekp
Copy link
Contributor Author

abhisekp commented Sep 6, 2016

Wow! This is awesome https://apitransformer.com/

Converted WADL format to Swagger 2.0 YAML format ✅

@MadLittleMods
Copy link
Member

@abhisekp Forget to push new commit with swagger file?

@abhisekp
Copy link
Contributor Author

abhisekp commented Sep 8, 2016

@MadLittleMods should I upload the Swagger file too? I guess it will need some clean up after conversion using the online tool.
And i'm not familiar with Swagger spec. (have to study it and i'm bit busy with something else)

@MadLittleMods
Copy link
Member

@abhisekp Moving to just Swagger 2.0 would be ideal. It sounded like you converted the file to swagger from your previous response.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants