W3C home > Mailing lists > Public > public-dwbp-wg@w3.org > December 2015

Re: Best Practices about Rest APIs

From: Herbert Van de Sompel <hvdsomp@gmail.com>
Date: Tue, 8 Dec 2015 13:05:46 -0700
Message-ID: <CAOywMHf8w01wGqRrnDs9GZ9Ok0v7jL-WJ=EpqR6fqXU1DTLS2g@mail.gmail.com>
To: Yasodara <yaso@nic.br>
Cc: Public DWBP WG <public-dwbp-wg@w3.org>, Herbert Van de Sompel <hvdsomp@gmail.com>
hi all,

I have a suggestion for a change, related to prior discussions about
"webby" approaches and REST/HATEOAS:

Under "Use Web Standardized Interfaces"

change:

Make use of http verbs, URIs, and response codes when designing APIs

to:

Make use of URIs, HTTP verbs, HTTP response codes, MIME types, typed
HTTP Links, and content negotiation when designing APIs

Cheers

Herbert

On Tue, Dec 8, 2015 at 12:01 PM, Yasodara <yaso@nic.br> wrote:
> Hi all
>
> I just opened a pull request with changes unfolded with Annete's
> iniciative, contemplating a lot of contributions and suggestions to the
> Best Practices.
>
>
> the main changes are based in the docs [1]
>
>
> Newton, do you think that this closes the issue that you raised about
> mentioning REST as a recommended architecture?
>
>
> cheers
> yaso
>
>
>
>
> [1]
> https://docs.google.com/document/d/13q2CvZjMkjXrg7Pv7aTRuU5UL2J_-py09Vs_zJoaLso/edit#
>
>
> --
> -
>
> CeWeb - Centro de estudos sobre tecnologias Web
> W3C Escritório Brasil
> NIC.br - CGI.br
> Phone: 55 11 5509-3537 (4025)
>



-- 
Herbert Van de Sompel
Digital Library Research & Prototyping
Los Alamos National Laboratory, Research Library
http://public.lanl.gov/herbertv/

==
Received on Tuesday, 8 December 2015 20:06:15 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 8 December 2015 20:06:15 UTC