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

Add Gitter API WADL file#43

Open
abhisekp wants to merge 1 commit into
gitterHQ:masterfrom
abhisekp:feat/gitter-api-wadl
Open

Add Gitter API WADL file#43
abhisekp wants to merge 1 commit into
gitterHQ:masterfrom
abhisekp:feat/gitter-api-wadl

Conversation

@abhisekp

@abhisekp abhisekp commented Sep 3, 2016

Copy link
Copy Markdown
Contributor

👉 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
Copy Markdown
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

abhisekp commented Sep 6, 2016

Copy link
Copy Markdown
Contributor Author

@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

abhisekp commented Sep 6, 2016

Copy link
Copy Markdown
Contributor Author

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

Converted WADL format to Swagger 2.0 YAML format ✅

@MadLittleMods

Copy link
Copy Markdown
Member

@abhisekp Forget to push new commit with swagger file?

@abhisekp

abhisekp commented Sep 8, 2016

Copy link
Copy Markdown
Contributor Author

@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
Copy Markdown
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