Telling Stories with APIs

Camille Baldock, Government Digital Service !

@camille_

Health and Safety

Contains JSON

!

“Digital storytelling”-free

Health and Safety

Contains JSON

!

“Digital storytelling”-free

Health and Safety

Contains JSON

!

“Digital storytelling”-free

Health and Safety

Contains JSON

!

“Digital storytelling”-free

Antoine de

Saint-Exupéry

The Little Prince

Order and manner in which a narrative is presented to a reader, listener, or

viewer

Books Chapters Entries

Books Chapters Entries

Books Chapters

Pages

What is the user need?

Events Characters

JSON API !

HAL

HAL embeds child documents recursively

JSON API flattens the entire graph of objects at the top level

Caching

I want to understand the context of the story

Antoine de

Saint-Exupéry

schema.org

JSON-LD

Augment existing APIs without introducing breaking changes

I want to get a deeper understanding of life

Wat

“It is the time you have wasted for your rose that makes your rose so important.”

What not to do…

http://www.contextus.net/stories

Interpretation Story

Thing

Contextualises

Interprets Subject

Supports

Read interpretations

Write interpretations

Adding operations to JSON-LD with HYDRA

JSON API HAL

JSON-LD HYDRA

…

Telling stories

Picture acknowledgements!

http://yesnobananas.wordpress.com/2013/09/10/is-it-nuts-to-ban-gluten-on-changes-to-the-allergy-labelling-laws/

https://www.destroyallsoftware.com/talks/wat

http://commons.wikimedia.org/wiki/File:Small_Red_Rose.JPG

http://www.contextus.net/stories

http://www.creerdesliens.com/2013/04/15/differentes-versions-du-petit-prince-en-chinois/

!

Thank you

!

@camille_