FOWA keynote

1. Telling Stories with APIs
Camille Baldock, Government Digital Service
!
@camille_

2. Health and Safety
Contains JSON
!
“Digital storytelling”-free

3. Health and Safety
Contains JSON
!
“Digital storytelling”-free

4. Health and Safety
Contains JSON
!
“Digital storytelling”-free

5. Health and Safety
Contains JSON
!
“Digital storytelling”-free

6. Antoine de
Saint-Exupéry

7. The Little Prince

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

9. Books
Chapters
Entries

10. Books
Chapters
Entries

11. Books
Chapters
Pages

13. What is the user need?

15. Events
Characters

16. JSON API
!
HAL

17. HAL embeds child
documents recursively

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

19. Caching

21. I want to understand the
context of the story

22. Antoine de
Saint-Exupéry

24. schema.org

25. JSON-LD

26. Augment existing APIs without
introducing breaking changes

28. I want to get a deeper
understanding of life

29. Wat

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

32. What not to do…

33. http://www.contextus.net/stories

34. Thing
Interprets Subject
Interpretation Contextualises
Story
Supports

35. Read interpretations

36. Write interpretations

37. Adding operations to
JSON-LD with HYDRA

38. JSON API
HAL
JSON-LD
HYDRA
…

39. Telling stories

44. 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/
!

45. Thank you
!
@camille_