W3C home > Mailing lists > Public > public-dwbp-wg@w3.org > May 2016

API BPs Example

From: Deirdre Lee <deirdre@derilinx.com>
Date: Tue, 3 May 2016 16:35:20 +0100
To: Data on the Web Best Practices Working Group <public-dwbp-wg@w3.org>
Message-ID: <5728C538.4000905@derilinx.com>
|Hi,

I've created an example that can be used for the API BPs|

    |Best Practice 21: Provide real-time access |
    |Best Practice 23: Make data available through an API|
    |Best Practice 24: Use Web Standards as the foundation of APIs|
    |Best Practice 25: Provide complete documentation for your API|

|
https://www.w3.org/2013/dwbp/wiki/Api_example
|

    |GET /bus/routes|
    |GET /bus/stops|
    |GET /bus/realtime|
    ||

|
For 'GET /bus/stops', I've used three different ways to describe bus-stops:
|

  * |using simple fields, |
  * |using fields defined in http://w3c.github.io/dwbp/dwbp-example.html
    and |
  * |using geojson to describe lat/long.|

|We should pick one approach. I think the third - simple fields and geojson.
|

|What do you think?
|

|Cheers,
Deirdre
|

-- 
------------------------------------
Deirdre Lee, CEO & Founder
Derilinx - Linked & Open Data Solutions
  
Web:      www.derilinx.com
Email:    deirdre@derilinx.com
Address:  11/12 Baggot Court, Dublin 2, D02 F891
Tel:      +353 (0)1 254 4316
Mob:      +353 (0)87 417 2318
Linkedin: ie.linkedin.com/in/leedeirdre/
Twitter:  @deirdrelee
Received on Tuesday, 3 May 2016 15:35:59 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 3 May 2016 15:35:59 UTC