darosh / angular-swagger-ui-material Goto Github PK

for https://apis-guru.github.io/ API discovery by @IvanGoncharov

• loading after back button is annoying
• will speed up full e2e test suite

Brainstorming ideas:

• show all metadata, probably json only to keep it simple
• some standard metadata could look like metadata list with icons in material ui
• version switch, tabs or select/option
• preview json/yaml
• link to github file
• download json/yaml (links moved from hub cards, maybe )
• open in
  • material ui
  • swagger ui
  • swagger editor
  • postman button? https://www.getpostman.com/docs/run_button
• validator badge
• disqus or g+ comments widget?
• SO link with prefilled tags? http://stackoverflow.com/questions/ask?tags=swagger+api+trello.com

@IvanGoncharov any other ideas?

I added badge
You can use it in your readme, just add following:

[![Tested on APIs.guru](http://apis-guru.github.io/api-models/banners/tested_on_banner.svg)](https://github.com/APIs-guru/api-models)

Any plans to port to ng2?

• probably via route and params which will make views and filters bookmarkable

Other swagger-json UI's are showing endpoints within all tags/categories that they list, while this one only shows them within their first tag.

Second, less important: because of the above problem, tags that has no unpresented paths don't get presented (a tile) at all.

modify this in form:
$http({
"headers": {
"accept": "application/json",
"content-type": "text/plain"
}
}

Your Hub looks very promising and I like to add it into this list:
https://github.com/APIs-guru/api-models#existing-integrations
If you agree, just send me PR or write here description for Hub page.
Note: I add integrations to the list in chronological order.

Basically, Angular Schema Form turn JSON Schemas into forms.

Since Swagger use a subset of JSON Schema to describe request and response bodies, it can be trivial to implement.

The tricky part is to handle content negociation properly on the request side of things. In fact, a Swagger definition may be converted into JSON, XML or into form "urlencoded" data depending on the consumes property.

BTW, nice work ;)

After angular/material#5068 or try workaround.

You can add x-apiClientRegistration it links to a page where you can get API key.
Not all APIs currently have it, but I try to add it for all new APIs.

Also x-unofficialSpec pretty important it's mean that this spec is not from official source.

This is more advanced by you can use x-providerName to group APIs.