Taking advantage of JsonSchema to create restful apis and a WebCMS.

Oct 14, 2013

A few weeks ago I went to San Francisco(CA) to attend some conferences: DataWeek.co and ApiWorld. It was my first trip to the US and it’s amazing!

Something interesting happened: One speaker did not show up to talk and then the organizers opened the space so that people could make some lightning talks or even share some interesting topics.

I’ve been working with many cool things at Globo.com. I’m a member of the team responsible for the BaaS (Backend as a Service) and API Manager/Gateway. Said that I decided to share how we’ve been taking advantage of JsonSchema to create restful APIs and our web cms at Globo.com.

What is JsonSchema?

JsonSchema is a clear human-and machine-readable way to describe APIs (links, for instance) and an existing data format. Besides that, it has a complete structural validation that may be useful for automated testing, or even validating client-submitted data.

In this lightning talk, I walk through how we use JSON schema to create our Restful Apis, so that our clients can follow the rel links to interact with the system and how we generate our webcms based on it. We’re using JsonForm to generate the output. But it’s not being maintained anymore and it uses the old draft-3 version. I highly recommend you to use angular-schema-form project rather than jsonform.

Cover photo by: Norm Cholewinski