RE: APIs to work with data on the web

Hi all,

Very interesting article indeed and related to discussions we're currently having with developers as part of Open Data Ireland on how best to publish/use machine-readable data.

I've added a use-case on it https://www.w3.org/2013/dwbp/wiki/Use_Cases Please feel free to add points or pick up on nuances of the conversation that I missed. Perhaps we could break this into multiple use-cases to look at each of the aspects in more detail?

Cheers,
Deirdre


From: Newton Calegari [mailto:newton@nic.br]
Sent: 17 March 2014 13:19
To: Makx Dekkers
Cc: public-dwbp-wg@w3.org
Subject: Re: APIs to work with data on the web

Hi Laufer, I didn't know the Socrata.
Thanks for share the link, Makx. Very interesting text and point of view about APIs.

BR,

Newton

Em 14/03/2014, à(s) 15:58, Makx Dekkers <mail@makxdekkers.com<mailto:mail@makxdekkers.com>> escreveu:


For a different perspective on APIs, see this: http://ruben.verborgh.org/blog/2013/11/29/the-lie-of-the-api/

Makx.

From: Newton Calegari [mailto:newton@nic.br]
Sent: Thursday, March 13, 2014 6:03 PM
To: public-dwbp-wg@w3.org<mailto:public-dwbp-wg@w3.org>
Subject: APIs to work with data on the web

Hi all,

          Last week, Yaso and I were talking about APIs and how they are important in all aspects of data on the web. APIs are one of the simplest ways to access and to distribute data across the web, and we think that is an important subject to be discussed on the WG.
          To talk about APIs, we obviously need to discuss about URI and descriptors. Carrasco written the first document [1<http://www.w3.org/2013/dwbp/wiki/Data_on_the_Web_URI_Best_Practices>] about it, besides there are a few messages discussing it.
          Moreover, I want to share some links I consider relevant and useful to discuss about this topic.
          Joshua Bloch, a software engineer and former Googler, published an article on InfoQ [2<http://www.infoq.com/articles/API-Design-Joshua-Bloch?utm_source=buffer&utm_campaign=Buffer&utm_content=buffer36801&utm_medium=twitter#.UvbdCPy0BT0.delicious>] site and made a presentation called "How to Design a Good API & Why it Matters" [3<http://www.infoq.com/presentations/effective-api-design>] (other Jushua's presentation about the same subject, but the video is hosted on YouTube [4<https://www.youtube.com/watch?v=aAb7hSCtvGw>]). These links are very interesting and I recommend to all of you, even who is already expert in API design.

[1] Data on the Web URI Best Practices: http://www.w3.org/2013/dwbp/wiki/Data_on_the_Web_URI_Best_Practices
[2] Joshua Bloch: Bumper-Sticker API Design: http://www.infoq.com/articles/API-Design-Joshua-Bloch?utm_source=buffer&utm_campaign=Buffer&utm_content=buffer36801&utm_medium=twitter#.UvbdCPy0BT0.delicious
[3] How to Design a Good API & Why it Matters: http://www.infoq.com/presentations/effective-api-design
[4] How to Design a Good API & Why it Matters (YouTube version): https://www.youtube..com/watch?v=aAb7hSCtvGw<https://www.youtube.com/watch?v=aAb7hSCtvGw>

Best Regards,
Newton