Missing "id" in 2.0 schema #103

Activity

1. webron commented on Sep 11, 2014

   

   webron

   on Sep 11, 2014

   Member

   More actions

   Are you referring to the "id" in the model/schema definitions? If so, it is indeed intentional. There's no need for it because the key for the definition is the id.
2. tlivings commented on Sep 12, 2014

   

   tlivings

   on Sep 12, 2014

   ContributorAuthor

   More actions

   Was actually referring to the top level id attribute of the schema itself.
3. webron commented on Sep 13, 2014

   

   webron

   on Sep 13, 2014

   Member

   More actions

   In that case, I don't follow. Can you give a concrete example of what you're referring to?
4. tlivings commented on Sep 13, 2014

   

   tlivings

   on Sep 13, 2014

   ContributorAuthor

   More actions

   https://github.com/wordnik/swagger-spec/blob/master/schemas/v1.2/apiDeclaration.json#L2
5. tlivings commented on Oct 13, 2014

   

   tlivings

   on Oct 13, 2014

   ContributorAuthor

   More actions

   Just to add something here. id can be used in resolving $ref, as per the spec, here:

   http://json-schema.org/latest/json-schema-core.html#anchor26

   JSON Schema offers facilities to alter the base URI against which a reference must resolve by the means of the "id" keyword;

   [edit] Specifically: http://json-schema.org/latest/json-schema-core.html#anchor28

   Containing an id property in this schema, as well as any referenced schema, is generally a good way to inform validators how to look up $ref.
6. webron commented on Oct 13, 2014

   

   webron

   on Oct 13, 2014

   Member

   More actions

   Yeah, didn't forget about it, just trying to figure out what would be the right id to give it. I hope to host it under our new swagger.io domain name and that should solve it.
7. tlivings commented on Oct 13, 2014

   

   tlivings

   on Oct 13, 2014

   ContributorAuthor

   More actions

   Thanks :) I just wanted to add more detail.
8. webron commented on Oct 13, 2014

   

   webron

   on Oct 13, 2014

   Member

   More actions

   That's great, I appreciate it. Always looking to learn more :)
9. webron

   closed this as completedin fcaa9bbon Oct 14, 2014