W3C home > Mailing lists > Public > public-rww@w3.org > August 2012

Re: MyProfile REST API.

From: Dominik Tomaszuk <ddooss@wp.pl>
Date: Sun, 12 Aug 2012 13:55:46 +0200
Message-ID: <502799C2.60000@wp.pl>
To: Henry Story <henry.story@bblfish.net>
CC: public-webid@w3.org, Andrei Sambra <andrei@fcns.eu>, public-rww <public-rww@w3.org>
On 12.08.2012 13:35, Henry Story wrote:
>
> On 12 Aug 2012, at 13:14, Dominik Tomaszuk<ddooss@wp.pl>  wrote:
>
>> On 12.08.2012 12:03, Henry Story wrote:
>>>
>>> On 12 Aug 2012, at 11:56, Dominik Tomaszuk<ddooss@wp.pl>   wrote:
>>>
>>>> On 12.08.2012 11:40, Andrei Sambra wrote:
>>>>> On 08/12/2012 11:34 AM, Dominik Tomaszuk wrote:
>>>>>> With message body? If yes, what type is the content?
>>>>>>
>>>>> The content type doesn't really matter for successful requests, since
>>>>> all you should care about is whether the request was successful or not.
>>>>>
>>>>> I suppose I can use EARL for the cases where you require a boolean
>>>>> answer, and the request is not successful (so you have the reason for
>>>>> your failure).
>>>> I suppose better than EARL is [1] and/or [2]. It will be nice if the content (including 200 and I guess 400) is an RDF graph.
>>>>
>>>>
>>>> [1] http://www.w3.org/2011/content#
>>>> [2] http://www.w3.org/2011/http#
>>>
>>> Those vocabularies seem way to precise: ways of describing http itself. You don't want to describe HTTP, you want to send a message back explaining ( in machine readable form ) what went wrong if asked for it in RDF.
>> I want rather to describe HTTP response, including status code in machine readable form.
>
> I think the reason I misunderstood is because you do not specify *which* HTTP response you want to describe.
>
> A) Is it the HTTP response itself that is returning a 400? Well there is no need to describe that response since HTTP already does that. The headers returned are at the top. To try to describe the same response with RDF would be to try to do SOAP in RDF again....
>     Well now I look at it HTTP 400 means Bad Request. So perhaps here is a case where the response could try
> to describe what was wrong in the REQUEST using RDF.
I would like to log (in RDF) responses and some details of it, because I 
want reason which requests should or should not be executed (and why) in 
future in the triplestores. This is some kind of cache system of RESTful 
operations.

> I think you can explain what went wrong in earl. So that would be useful to add more details...
Nothing wrong in EARL, but personally I used more brevity Test Metadata [1].

[1] http://www.w3.org/2006/03/test-description#

Dominik
>
>
>>
>> Dominik
>>
>>>
>>> Henry
>>>
>>>>
>>>> Dominik
>>>>
>>>>>
>>>>> Andrei
>>>>>
>>>>>> On 11.08.2012 22:42, Andrei Sambra wrote:
>>>>>>> All successful requests return 200.
>>>>>>>
>>>>>>> ----- Reply message -----
>>>>>>> From: "Dominik Tomaszuk"<ddooss@wp.pl>
>>>>>>> To: "Andrei Sambra"<andrei@fcns.eu>
>>>>>>> Cc: "WebID"<public-webid@w3.org>, "public-rww"<public-rww@w3.org>
>>>>>>> Subject: MyProfile REST API.
>>>>>>> Date: Sat, Aug 11, 2012 22:15
>>>>>>>
>>>>>>>
>>>>>>> Andrei,
>>>>>>>
>>>>>>> On 10.08.2012 23:15, Andrei Sambra wrote:
>>>>>>>> Another example for deleting the cached copy of a profile:
>>>>>>>>
>>>>>>>> The request:
>>>>>>>> HTTP/1.1 DELETE
>>>>>>>> https://auth.my-profile.eu/profile/cache/?webid=<urlencoded WebID>
>>>>>>>>
>>>>>>>> Returns*:
>>>>>>>> Successfully deleted profile
>>>>>>> https://my-profile.eu/people/deiu/card#me.
>>>>>>>>
>>>>>>>> *for now, the operation will be performed only if the request is
>>>>>>> made by
>>>>>>>> profile owner, or on his/her behalf (!)
>>>>>>> What HTTP status code is returned when it is successful? 200 or 204?
>>>>>>>
>>>>>>> Cheers,
>>>>>>> Dominik
>>>>>>
>>>>>
>>>>>
>>>>>
>>>>
>>>>
>>>
>>> Social Web Architect
>>> http://bblfish.net/
>>>
>>>
>>>
>>>
>>
>
> Social Web Architect
> http://bblfish.net/
>
>
>
>
Received on Sunday, 12 August 2012 11:56:11 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Sunday, 12 August 2012 11:56:11 GMT