Tony Tam fehguy

==========

Not to be confused with the swagger framework versioning, the swagger specification itself is versioned for compatibility. You can see information about previous versions in the wiki.

Philosophically, any changes to the spec are absorbed into the tools for one-version backwards compatibility. So the swagger-ui will work with both swagger-spec 1.1 and 1.2. It is not tested against older versions (prior to 1.1). Changing a specification typically causes some heartache and pain, so the changes introduced are usually not just for fun--they have a history of issues or confusion behind them, which mandates the change.

You can use the swagger-codegen to migrate your swagger 1.1 spec! Please see HERE for details.

That said, here's a transition guide for the 1.2 specification.

	package.json:
	{
	"dependencies": {
	"swagger-client": "2.1.2-M1"
	}
	}


	test.js:
	var swagger = require('swagger-client');

	opts:
	properties:
	modelPackage: "com.reverb.models"
	apiPackage: "com.reverb.apis"
	groupId: "com.reverb.swagger"
	artifactId: "swagger-server"
	artifactVersion: "1.0.0"
	uri: "http://petstore.swagger.wordnik.com/api/api-docs"
	model:
	apiVersion: "5.0.0-D0"

	import com.wordnik.swagger.converter.*;

	String jsonString = "{" +
	" \"id\": \"Date\"," +
	" \"properties\": {" +
	" \"value\": {" +
	" \"required\": true," +
	" \"description\": \"UUID in string format\"," +
	" \"type\": \"string\","
	" }" +

	window.authorizations.add("api_key", new ApiKeyAuthorization("api_key", "YOUR_KEY", "header"));

	var args = {word: "cat"};

	wordnik = new SwaggerApi({
	url: "https://api.wordnik.com/v4/resources.json",
	success: function() {
	if(wordnik.ready === true) {
	wordnik.word.getDefinitions(args, function(data){
	var definitions = data.obj; console.log(definitions[0].word);

	fehguy:swagger-core-master tony$ git status .
	On branch master
	Your branch is up-to-date with 'origin/master'.

	nothing to commit, working directory clean
	fehguy:swagger-core-master tony$ mvn clean install
	[INFO] Scanning for projects...
	[WARNING]
	[WARNING] Some problems were encountered while building the effective model for com.wordnik:swagger-utils_2.10:jar:1.3.5
	[WARNING] 'dependencies.dependency.(groupId:artifactId:type:classifier)' must be unique: org.reflections:reflections:jar -> duplicate declaration of version 0.9.8 @ line 57, column 17

	def listing(docRoot: String, app: Application, sc: ServletConfig): Option[Map[String, ApiListing]] = {
	var _cache: Option[Map[String, ApiListing]] = None

	_cache.orElse{
	LOGGER.debug("loading cache")
	ClassReaders.reader.map{reader =>
	ScannerFactory.scanner.map(scanner => {
	val classes = scanner match {
	case scanner: JaxrsScanner => scanner.asInstanceOf[JaxrsScanner].classesFromContext(app, null)
	case _ => List()

	apiVersion: 1.0.0
	swaggerVersion: "1.2"
	basePath: "http://localhost:8002/api"
	resourcePath: /pet
	produces:
	- application/json
	- application/xml
	- text/plain
	- text/html
	apis:

	var client = require("swagger-client");

	client.authorizations.add("key", new client.ApiKeyAuthorization("api_key", "YOUR_KEY", "header"))

	var swagger = new client.SwaggerApi({
	url: "https://api.wordnik.com/v4/resources.json",
	success: function() {
	if(swagger.ready === true) {
	swagger.apis.word.getDefinitions({word:"cat"},
	function(data) {