News in JSON

Stuart Myles * Associated Press * 21st October 2014

https://www.flickr.com/photos/75487768@N04/12188256115

Remind Me: What is JSON?JSON = JavaScript Object Notation http://json.org/

Name / value pairs: a fieldname in quotes, a colon, a value in quotes

"givenname" : "Evan"

Objects: written inside curly braces, may contain multiple NVPs

{"givenname" : "Evan", "familyname" : "Sandhaus"}

Arrays: Written inside square braces, may contain multiple objects{"iptcdelegates": [ { "givenname": "Jayson", "familyname": “Lorenzen"}, { "givenname": "Jeremy", "familyname": "Brooks"}, { "givenname": "Trond", "familyname": "Huso" }]}

© 2014 IPTC (www.iptc.org) All rights reserved 2

Remind Me: Why News in JSON?

Lightweight, easy to parse format

Increasingly popular alternative to / replacement for XML

Two principle use cases:

data interchange (e.g. APIs) with an emphasis on partial representation

data at rest (e.g. search engines like Elastic Search or MongoDB)

Not simply translating from any existing XML standard into JSON

Determine how to represent key properties and structures

Hand crafted, rather than mechanically translating from XML into JSON

Goal: comprehensive standard, lightweight instance documents

© 2014 IPTC (www.iptc.org) All rights reserved 3

ninjs Overview

© 2014 IPTC (www.iptc.org) All rights reserved 4

http://groups.yahoo.com/neo/groups/iptc-news-in-json-dev

ninjs Data Model

© 2014 IPTC (www.iptc.org) All rights reserved 5

http://dev.iptc.org/ninjs

ninjs 1.1

• ninjs is a JSON representation of a news item– Text, Photo, Graphic, Video, Audio, Package

• You can represent a complete item, with all properties– For instance in an internal CMS like MongoDB

• Or you may want to convey key properties– For instance as an API response

• The representationtype property indicates how complete– Either “full” or “partial”

• Associations are themselves ninjs documents– You may include complete or partial representations

© 2014 IPTC (www.iptc.org) All rights reserved 6

A Complete NINJS 1.1 Article

{    "uri" : "http://ninjs.example.com/newsitems/20130709simp123",    "type" : "text",    "versioncreated" : "2013-07-09T10:37:00Z",    "byline" : "Paulo Santalucia and Frances d'Emilio",    "headline" : "Captain of wrecked cruise ship on trial in Italy",    "body_text" : "GROSSETO, Italy (EP) -- The trial of the captain of the shipwrecked Costa Concordia cruise liner has begun in a theater converted into a courtroom …"}

© 2014 IPTC (www.iptc.org) All rights reserved 7

Who Uses JSON? ninjs?

© 2014 IPTC (www.iptc.org) All rights reserved 8

https://www.flickr.com/photos/gageskidmore/4377317850

ninjs Resources

• The ninjs development website is a trove of information http://dev.iptc.org/ninjs

• ninjs JSON schema http://www.iptc.org/std/ninjs/ninjs-schema_1.1.json• Uses JSON schema draft standard http://json-schema.org/

– Validation http://dev.iptc.org/ninjs-Validation-of-ninjs-Objects

• ninjs examples– Text http://dev.iptc.org/ninjs-Examples-1– Photo http://dev.iptc.org/ninjs-Examples-2– Multimedia http://dev.iptc.org/ninjs-Examples-3

• Best practices and how tos http://dev.iptc.org/ninjs-Best-Practices-and-How-Tos

• ninjs github https://github.com/iptc/newsinjson• ninjs feedback forum http://dev.iptc.org/Forum-5

and mail list iptc-news-in-json-dev@yahoogroups.com

© 2014 IPTC (www.iptc.org) All rights reserved 9

Sports in JSON

• Develop a standard JSON representation of sports data• Working with the SportsML group• You can participate

– via the News in JSON list – iptc-news-in-json-dev@yahoogroups.com– Join the working phone calls

© 2014 IPTC (www.iptc.org) All rights reserved 10

Date and Place of Next Meeting

New York, USA March, 2015

Danke und auf Wiedersehen!

© 2014 IPTC (www.iptc.org) All rights reserved 11

https://www.flickr.com/photos/arnebornheim/8080932433