Comment on RAML - RESTful API modeling languageparentComments−tootie12yA schema allows for declarative validation and allows it to be defined once and once per consumer.−dragonwriter12yA well-defined media-type does much the same thing and is what REST is centered on.An API based on HTTP and schemas rather than media types for content definition/validation is more like SOAP than REST.OTOH, an API based on resource-oriented hypermedia could incidentally use media types that are defined in terms of schemas, and still be REST.
Comments
A schema allows for declarative validation and allows it to be defined once and once per consumer.
A well-defined media-type does much the same thing and is what REST is centered on.
An API based on HTTP and schemas rather than media types for content definition/validation is more like SOAP than REST.
OTOH, an API based on resource-oriented hypermedia could incidentally use media types that are defined in terms of schemas, and still be REST.