A Simple API for Schools

This is the start of the documentation of a very simple API I built for schools data as part of the very wonderful Rewired State. There is a blog post describing why and a bit of how I built it.

At the moment there is about 10% of the data in there, I'm going to load the rest up, fix the items endpoint where I introduced a bug earlier, add an additional endpoint which I think will be useful and build a mini-explorer and a couple of clients for it. It's likely to be later this week I do that as I'm involved in something which launches on Tuesday and I think the early part of the week might be busy ;-)

Sample queries

There are currently three endpoints item, search and items. At the moment only XML is supported. Will be adding in JSON this week. I'll also hopefully add in some search filtering.

/schools-api/item

Get a school by the URN for the school (6 digit unique id) - http://schoolsapi.jaggeree.com/schools-api/item/130908

/schools-api/search

Search for Brighton - http://schoolsapi.jaggeree.com/schools-api/search?query=Brighton

/schools-api/items

Schools with town listed as Brighton - http://schoolsapi.jaggeree.com/schools-api/items/town/Brighton

Schools with the name "Pipworth Community Primary School" - http://schoolsapi.jaggeree.com/schools-api/items/school_name/Pipworth%20Community%20Primary%20School

Schools with the LEA of West Sussex - http://schoolsapi.jaggeree.com/schools-api/items/local_authority_name/West%20Sussex

Schools in the county of South Yorkshire - http://schoolsapi.jaggeree.com/schools-api/items/county/South%20Yorkshire