jsonschema

I'm looking to generate JSON Schema for a WebAPI, including documentation from the XML comments. Its primarily so that I can then import that into our API docs (using apiary.io) I've managed to get a workaround solution by adding swagger (and swashbuckle) and then using the raw link on each service - but ideally I'd like something a bit cleaner, that works across all apis (this has to be done per service / controller), and didnt have so many dependencies. Before I go and look at how swagger is doing this and seeing if it can be extracted, would be good to know if there are existing ways to do

I am trying to document an existing use of JSON using json-schema. The system permits the following two possabilities for one of the object attributes. Either { "tracking_number" : 123 } Or { "tracking_number" : [ 123, 124, 125 ] } How can I express this using json schema? Use anyOf to assert that the property must conform to one or another schema. { "type": "object", "properties": { "tracking_number": { "anyOf": [ { "$ref": "#/definitions/tracking_number" }, { "type": "array", "items": { "$ref": "#/definitions/tracking_number" } ] }, "definitions": { "tracking_number": { "type": "integer" } }

I have a json document in which a part can be either null or a subobject, like this: [{ "owner":null }, { "owner":{ "id":1 } }] The question is if its possible to model this in json schema draft v4 using ref? What I would like is something like this { "type":"object", "properties":{ "owner":{ "type":["null", "object"], "$ref":"#/definitions/id" } }, "definitions":{ "id":{ "type":"object", "properties":{ "id":{ "type":"number" } } } } } What you've posted should work, if you remove the "type":"object" from the definition. However, a neater, more explicit way to specify alternatives is to use

I have a POJO class public class Stock{ int id; String name; Date date; } Are there any annotations or development framework/api that can convert POJO to JSON schema like below {"id": { "type" : "int" }, "name":{ "type" : "string" } "date":{ "type" : "Date" } } and also i can expand the schema to add information like "Required" : "Yes", description for each field, etc., by specifying some annotations or configurations on POJO and can generate JSON Schema like below. {"id": { "type" : "int", "Required" : "Yes", "format" : "id must not be greater than 99999", "description" : "id of the stock" },

I am using json-schema and wanting to only allow properties that are declared in this file to pass validation. For instance if a user passes a "name" property in their json object it will fail this schema because "name" is not listed here as a property. Is there some function similar to "required" that will only allow the listed properties to pass? { "$schema": "http://json-schema.org/draft-04/schema#", "title": "Accounting Resource - Add Item", "type": "object", "properties": { "itemNumber": { "type":"string", "minimum": 3 }, "title": { "type":"string", "minimum": 5 }, "description": { "type"