W3C home > Mailing lists > Public > public-dwbp-wg@w3.org > March 2014

RE: APIs to work with data on the web

From: <Manuel.CARRASCO-BENITEZ@ec.europa.eu>
Date: Tue, 18 Mar 2014 12:20:27 +0000
To: <adler1@us.ibm.com>, <Deirdre.Lee@deri.org>
CC: <mail@makxdekkers.com>, <newton@nic.br>, <public-dwbp-wg@w3.org>
Message-ID: <39DB516E46C0E842A2CFFF1BBB7412F152F54A94@S-DC-ESTF03-B.net1.cec.eu.int>

-        Resources should be addressable with a URI

-        One should aim a common interface for humans and machine



From: Steven Adler [mailto:adler1@us.ibm.com]
Sent: Monday, March 17, 2014 4:34 PM
To: Lee, Deirdre
Cc: Makx Dekkers; Newton Calegari; public-dwbp-wg@w3.org
Subject: RE: APIs to work with data on the web

Excellent use case which begins to explore and spell out the advantages and trade-offs of using API's to access Open Data.  I would like to explore this topic in greater detail.  My own personal preference is data access by HTTP and URI, because it provides a common interface for humans and machines.  But are there performance implications?

Best Regards,


Motto: "Do First, Think, Do it Again"


"Lee, Deirdre" <Deirdre.Lee@deri.org<mailto:Deirdre.Lee@deri.org>>


Newton Calegari <newton@nic.br<mailto:newton@nic.br>>, Makx Dekkers <mail@makxdekkers.com<mailto:mail@makxdekkers.com>>


"public-dwbp-wg@w3.org<mailto:public-dwbp-wg@w3.org>" <public-dwbp-wg@w3.org<mailto:public-dwbp-wg@w3.org>>


03/17/2014 11:19 AM


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?


From: Newton Calegari [mailto:newton@nic.br]
Sent: 17 March 2014 13:19
To: Makx Dekkers
Cc: public-dwbp-wg@w3.org<mailto: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.



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/


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,

Received on Tuesday, 18 March 2014 12:20:58 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:24:12 UTC