You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@stratos.apache.org by Mariangela Hills <ma...@wso2.com> on 2015/04/01 11:19:54 UTC
[Q?] When signing up to a multi-tenant application should 200 or 201
be returned?
Hi Devs,
Is it correct that the HTTP status code 200 is returned [1] when signing up
to multi-tenant applications and that a Location header URL is not
returned? Just want to check whether this is correct or not?
[1]
Admin16s-MacBook-Air:artifacts Admin16$ curl -X POST -H "Content-Type:
application/json" -d @'application-signup.json' -k -v -u admin:admin
https://localhost:9443/api/applications/single-cartridge-app/signup
* About to connect() to localhost port 9443 (#0)
* Trying ::1...
* connected
* Connected to localhost (::1) port 9443 (#0)
* SSLv3, TLS handshake, Client hello (1):
* SSLv3, TLS handshake, Server hello (2):
* SSLv3, TLS handshake, CERT (11):
* SSLv3, TLS handshake, Server key exchange (12):
* SSLv3, TLS handshake, Server finished (14):
* SSLv3, TLS handshake, Client key exchange (16):
* SSLv3, TLS change cipher, Client hello (1):
* SSLv3, TLS handshake, Finished (20):
* SSLv3, TLS change cipher, Client hello (1):
* SSLv3, TLS handshake, Finished (20):
* SSL connection using DHE-RSA-AES256-SHA
* Server certificate:
* subject: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
* start date: 2010-02-19 07:02:26 GMT
* expire date: 2035-02-13 07:02:26 GMT
* common name: localhost (matched)
* issuer: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
* SSL certificate verify result: unable to get local issuer certificate
(20), continuing anyway.
* Server auth using Basic with user 'admin'
> POST /api/applications/single-cartridge-app/signup HTTP/1.1
> Authorization: Basic YWRtaW46YWRtaW4=
> User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0
OpenSSL/0.9.8| zlib/1.2.5
> Host: localhost:9443
> Accept: */*
> Content-Type: application/json
> Content-Length: 428
>
* upload completely sent off: 428 out of 428 bytes
< HTTP/1.1 200 OK
< Date: Tue, 31 Mar 2015 10:08:58 GMT
< Content-Type: application/json
< Transfer-Encoding: chunked
< Server: WSO2 Carbon Server
<
* Connection #0 to host localhost left intact
{"statusCode":200,"successMessage":"Successfully signed up for:
[application] single-cartridge-app"}* Closing connection #0
Regards,
Mariangela
*--*
Mariangela Hills
Senior Technical Writer
*WSO2, Inc.*lean.enterprise.middleware.
Re: [Q?] When signing up to a multi-tenant application should 200 or
201 be returned?
Posted by Mariangela Hills <ma...@wso2.com>.
Isuru, thanks loads for the explanation!
Regards,
Mariangela
*--*
Mariangela Hills
Senior Technical Writer
*WSO2, Inc.*lean.enterprise.middleware.
On Wed, Apr 1, 2015 at 3:59 PM, Isuru Haththotuwa <is...@apache.org> wrote:
> Hi Mari,
>
> A POST should return 201 if the request results in creation of a new
> entity AFAIK. In this case it should be a resource described by the URI
> [1]. AFAIK, here its not the case, therefore, its ok to return 200.
>
> [1]. https://localhost:9443/api/applications/single-cartridge-app/signups/signup
>
> <https://localhost:9443/api/applications/single-cartridge-app/signups/signup1>
>
> On Wed, Apr 1, 2015 at 3:35 PM, Mariangela Hills <ma...@wso2.com>
> wrote:
>
>> Isuru, thanks for your quick response!
>>
>> I raised this questions as I thought that all POST methods should return
>> the 201 HTTP status code. Guess I was wrong.
>>
>> curl -X POST -H "Content-Type: application/json" -d
>> @'artifacts/application-signup.json' -k -v -u admin:admin
>> https://localhost:9443/api/applications/single-cartridge-app/signup
>>
>>
>> Regards,
>> Mariangela
>>
>>
>>
>>
>> *--*
>> Mariangela Hills
>> Senior Technical Writer
>>
>> *WSO2, Inc.*lean.enterprise.middleware.
>> w: http://wso2.com
>>
>>
>> On Wed, Apr 1, 2015 at 2:58 PM, Isuru Haththotuwa <is...@apache.org>
>> wrote:
>>
>>> Hi,
>>>
>>> On Wed, Apr 1, 2015 at 2:49 PM, Mariangela Hills <ma...@wso2.com>
>>> wrote:
>>>
>>>> Hi Devs,
>>>>
>>>> Is it correct that the HTTP status code 200 is returned [1] when
>>>> signing up to multi-tenant applications and that a Location header URL
>>>> is not returned? Just want to check whether this is correct or not?
>>>>
>>> AFAIK this is not a problem. The Location header should be sent for
>>> statuses 3xx, 201 or 202.
>>>
>>>>
>>>>
>>>> [1]
>>>> Admin16s-MacBook-Air:artifacts Admin16$ curl -X POST -H "Content-Type:
>>>> application/json" -d @'application-signup.json' -k -v -u admin:admin
>>>> https://localhost:9443/api/applications/single-cartridge-app/signup
>>>> * About to connect() to localhost port 9443 (#0)
>>>> * Trying ::1...
>>>> * connected
>>>> * Connected to localhost (::1) port 9443 (#0)
>>>> * SSLv3, TLS handshake, Client hello (1):
>>>> * SSLv3, TLS handshake, Server hello (2):
>>>> * SSLv3, TLS handshake, CERT (11):
>>>> * SSLv3, TLS handshake, Server key exchange (12):
>>>> * SSLv3, TLS handshake, Server finished (14):
>>>> * SSLv3, TLS handshake, Client key exchange (16):
>>>> * SSLv3, TLS change cipher, Client hello (1):
>>>> * SSLv3, TLS handshake, Finished (20):
>>>> * SSLv3, TLS change cipher, Client hello (1):
>>>> * SSLv3, TLS handshake, Finished (20):
>>>> * SSL connection using DHE-RSA-AES256-SHA
>>>> * Server certificate:
>>>> * subject: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
>>>> * start date: 2010-02-19 07:02:26 GMT
>>>> * expire date: 2035-02-13 07:02:26 GMT
>>>> * common name: localhost (matched)
>>>> * issuer: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
>>>> * SSL certificate verify result: unable to get local issuer
>>>> certificate (20), continuing anyway.
>>>> * Server auth using Basic with user 'admin'
>>>> > POST /api/applications/single-cartridge-app/signup HTTP/1.1
>>>> > Authorization: Basic YWRtaW46YWRtaW4=
>>>> > User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0
>>>> OpenSSL/0.9.8| zlib/1.2.5
>>>> > Host: localhost:9443
>>>> > Accept: */*
>>>> > Content-Type: application/json
>>>> > Content-Length: 428
>>>> >
>>>> * upload completely sent off: 428 out of 428 bytes
>>>> < HTTP/1.1 200 OK
>>>> < Date: Tue, 31 Mar 2015 10:08:58 GMT
>>>> < Content-Type: application/json
>>>> < Transfer-Encoding: chunked
>>>> < Server: WSO2 Carbon Server
>>>> <
>>>> * Connection #0 to host localhost left intact
>>>> {"statusCode":200,"successMessage":"Successfully signed up for:
>>>> [application] single-cartridge-app"}* Closing connection #0
>>>>
>>>>
>>>>
>>>> Regards,
>>>> Mariangela
>>>>
>>>>
>>>>
>>>>
>>>> *--*
>>>> Mariangela Hills
>>>> Senior Technical Writer
>>>>
>>>> *WSO2, Inc.*lean.enterprise.middleware.
>>>>
>>>> --
>>>> Thanks and Regards,
>>>>
>>>> Isuru H.
>>>> +94 716 358 048
>>>>
>>>> --
>>>> <%2B94%20716%20358%20048>
>>>> <%2B94%20716%20358%20048>
>>>> Thanks and Regards,
>>>>
>>>> Isuru H.
>>>> <%2B94%20716%20358%20048>
>>>> +94 716 358 048* <http://wso2.com/>*
>>>>
>>>>
>>>> * <http://wso2.com/>*
>>>>
>>>>
>>>>
Re: [Q?] When signing up to a multi-tenant application should 200 or
201 be returned?
Posted by Isuru Haththotuwa <is...@apache.org>.
Hi Mari,
A POST should return 201 if the request results in creation of a new entity
AFAIK. In this case it should be a resource described by the URI [1].
AFAIK, here its not the case, therefore, its ok to return 200.
[1]. https://localhost:9443/api/applications/single-cartridge-app/signups/signup
<https://localhost:9443/api/applications/single-cartridge-app/signups/signup1>
On Wed, Apr 1, 2015 at 3:35 PM, Mariangela Hills <ma...@wso2.com>
wrote:
> Isuru, thanks for your quick response!
>
> I raised this questions as I thought that all POST methods should return
> the 201 HTTP status code. Guess I was wrong.
>
> curl -X POST -H "Content-Type: application/json" -d
> @'artifacts/application-signup.json' -k -v -u admin:admin
> https://localhost:9443/api/applications/single-cartridge-app/signup
>
>
> Regards,
> Mariangela
>
>
>
>
> *--*
> Mariangela Hills
> Senior Technical Writer
>
> *WSO2, Inc.*lean.enterprise.middleware.
> w: http://wso2.com
>
>
> On Wed, Apr 1, 2015 at 2:58 PM, Isuru Haththotuwa <is...@apache.org>
> wrote:
>
>> Hi,
>>
>> On Wed, Apr 1, 2015 at 2:49 PM, Mariangela Hills <ma...@wso2.com>
>> wrote:
>>
>>> Hi Devs,
>>>
>>> Is it correct that the HTTP status code 200 is returned [1] when signing
>>> up to multi-tenant applications and that a Location header URL is not
>>> returned? Just want to check whether this is correct or not?
>>>
>> AFAIK this is not a problem. The Location header should be sent for
>> statuses 3xx, 201 or 202.
>>
>>>
>>>
>>> [1]
>>> Admin16s-MacBook-Air:artifacts Admin16$ curl -X POST -H "Content-Type:
>>> application/json" -d @'application-signup.json' -k -v -u admin:admin
>>> https://localhost:9443/api/applications/single-cartridge-app/signup
>>> * About to connect() to localhost port 9443 (#0)
>>> * Trying ::1...
>>> * connected
>>> * Connected to localhost (::1) port 9443 (#0)
>>> * SSLv3, TLS handshake, Client hello (1):
>>> * SSLv3, TLS handshake, Server hello (2):
>>> * SSLv3, TLS handshake, CERT (11):
>>> * SSLv3, TLS handshake, Server key exchange (12):
>>> * SSLv3, TLS handshake, Server finished (14):
>>> * SSLv3, TLS handshake, Client key exchange (16):
>>> * SSLv3, TLS change cipher, Client hello (1):
>>> * SSLv3, TLS handshake, Finished (20):
>>> * SSLv3, TLS change cipher, Client hello (1):
>>> * SSLv3, TLS handshake, Finished (20):
>>> * SSL connection using DHE-RSA-AES256-SHA
>>> * Server certificate:
>>> * subject: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
>>> * start date: 2010-02-19 07:02:26 GMT
>>> * expire date: 2035-02-13 07:02:26 GMT
>>> * common name: localhost (matched)
>>> * issuer: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
>>> * SSL certificate verify result: unable to get local issuer
>>> certificate (20), continuing anyway.
>>> * Server auth using Basic with user 'admin'
>>> > POST /api/applications/single-cartridge-app/signup HTTP/1.1
>>> > Authorization: Basic YWRtaW46YWRtaW4=
>>> > User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0
>>> OpenSSL/0.9.8| zlib/1.2.5
>>> > Host: localhost:9443
>>> > Accept: */*
>>> > Content-Type: application/json
>>> > Content-Length: 428
>>> >
>>> * upload completely sent off: 428 out of 428 bytes
>>> < HTTP/1.1 200 OK
>>> < Date: Tue, 31 Mar 2015 10:08:58 GMT
>>> < Content-Type: application/json
>>> < Transfer-Encoding: chunked
>>> < Server: WSO2 Carbon Server
>>> <
>>> * Connection #0 to host localhost left intact
>>> {"statusCode":200,"successMessage":"Successfully signed up for:
>>> [application] single-cartridge-app"}* Closing connection #0
>>>
>>>
>>>
>>> Regards,
>>> Mariangela
>>>
>>>
>>>
>>>
>>> *--*
>>> Mariangela Hills
>>> Senior Technical Writer
>>>
>>> *WSO2, Inc.*lean.enterprise.middleware.
>>>
>>> --
>>> Thanks and Regards,
>>>
>>> Isuru H.
>>> +94 716 358 048
>>>
>>> --
>>> Thanks and Regards,
>>>
>>> Isuru H.
>>> +94 716 358 048* <http://wso2.com/>*
>>>
>>>
>>> * <http://wso2.com/>*
>>>
>>>
>>>
Re: [Q?] When signing up to a multi-tenant application should 200 or
201 be returned?
Posted by Mariangela Hills <ma...@wso2.com>.
Isuru, thanks for your quick response!
I raised this questions as I thought that all POST methods should return
the 201 HTTP status code. Guess I was wrong.
curl -X POST -H "Content-Type: application/json" -d
@'artifacts/application-signup.json' -k -v -u admin:admin
https://localhost:9443/api/applications/single-cartridge-app/signup
Regards,
Mariangela
*--*
Mariangela Hills
Senior Technical Writer
*WSO2, Inc.*lean.enterprise.middleware.
w: http://wso2.com
On Wed, Apr 1, 2015 at 2:58 PM, Isuru Haththotuwa <is...@apache.org> wrote:
> Hi,
>
> On Wed, Apr 1, 2015 at 2:49 PM, Mariangela Hills <ma...@wso2.com>
> wrote:
>
>> Hi Devs,
>>
>> Is it correct that the HTTP status code 200 is returned [1] when signing
>> up to multi-tenant applications and that a Location header URL is not
>> returned? Just want to check whether this is correct or not?
>>
> AFAIK this is not a problem. The Location header should be sent for
> statuses 3xx, 201 or 202.
>
>>
>>
>> [1]
>> Admin16s-MacBook-Air:artifacts Admin16$ curl -X POST -H "Content-Type:
>> application/json" -d @'application-signup.json' -k -v -u admin:admin
>> https://localhost:9443/api/applications/single-cartridge-app/signup
>> * About to connect() to localhost port 9443 (#0)
>> * Trying ::1...
>> * connected
>> * Connected to localhost (::1) port 9443 (#0)
>> * SSLv3, TLS handshake, Client hello (1):
>> * SSLv3, TLS handshake, Server hello (2):
>> * SSLv3, TLS handshake, CERT (11):
>> * SSLv3, TLS handshake, Server key exchange (12):
>> * SSLv3, TLS handshake, Server finished (14):
>> * SSLv3, TLS handshake, Client key exchange (16):
>> * SSLv3, TLS change cipher, Client hello (1):
>> * SSLv3, TLS handshake, Finished (20):
>> * SSLv3, TLS change cipher, Client hello (1):
>> * SSLv3, TLS handshake, Finished (20):
>> * SSL connection using DHE-RSA-AES256-SHA
>> * Server certificate:
>> * subject: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
>> * start date: 2010-02-19 07:02:26 GMT
>> * expire date: 2035-02-13 07:02:26 GMT
>> * common name: localhost (matched)
>> * issuer: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
>> * SSL certificate verify result: unable to get local issuer certificate
>> (20), continuing anyway.
>> * Server auth using Basic with user 'admin'
>> > POST /api/applications/single-cartridge-app/signup HTTP/1.1
>> > Authorization: Basic YWRtaW46YWRtaW4=
>> > User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0
>> OpenSSL/0.9.8| zlib/1.2.5
>> > Host: localhost:9443
>> > Accept: */*
>> > Content-Type: application/json
>> > Content-Length: 428
>> >
>> * upload completely sent off: 428 out of 428 bytes
>> < HTTP/1.1 200 OK
>> < Date: Tue, 31 Mar 2015 10:08:58 GMT
>> < Content-Type: application/json
>> < Transfer-Encoding: chunked
>> < Server: WSO2 Carbon Server
>> <
>> * Connection #0 to host localhost left intact
>> {"statusCode":200,"successMessage":"Successfully signed up for:
>> [application] single-cartridge-app"}* Closing connection #0
>>
>>
>>
>> Regards,
>> Mariangela
>>
>>
>>
>>
>> *--*
>> Mariangela Hills
>> Senior Technical Writer
>>
>> *WSO2, Inc.*lean.enterprise.middleware.
>>
>> --
>> Thanks and Regards,
>>
>> Isuru H.
>> +94 716 358 048* <http://wso2.com/>*
>>
>>
>> * <http://wso2.com/>*
>>
>>
>>
Re: [Q?] When signing up to a multi-tenant application should 200 or
201 be returned?
Posted by Isuru Haththotuwa <is...@apache.org>.
Hi,
On Wed, Apr 1, 2015 at 2:49 PM, Mariangela Hills <ma...@wso2.com>
wrote:
> Hi Devs,
>
> Is it correct that the HTTP status code 200 is returned [1] when signing
> up to multi-tenant applications and that a Location header URL is not
> returned? Just want to check whether this is correct or not?
>
AFAIK this is not a problem. The Location header should be sent for
statuses 3xx, 201 or 202.
>
>
> [1]
> Admin16s-MacBook-Air:artifacts Admin16$ curl -X POST -H "Content-Type:
> application/json" -d @'application-signup.json' -k -v -u admin:admin
> https://localhost:9443/api/applications/single-cartridge-app/signup
> * About to connect() to localhost port 9443 (#0)
> * Trying ::1...
> * connected
> * Connected to localhost (::1) port 9443 (#0)
> * SSLv3, TLS handshake, Client hello (1):
> * SSLv3, TLS handshake, Server hello (2):
> * SSLv3, TLS handshake, CERT (11):
> * SSLv3, TLS handshake, Server key exchange (12):
> * SSLv3, TLS handshake, Server finished (14):
> * SSLv3, TLS handshake, Client key exchange (16):
> * SSLv3, TLS change cipher, Client hello (1):
> * SSLv3, TLS handshake, Finished (20):
> * SSLv3, TLS change cipher, Client hello (1):
> * SSLv3, TLS handshake, Finished (20):
> * SSL connection using DHE-RSA-AES256-SHA
> * Server certificate:
> * subject: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
> * start date: 2010-02-19 07:02:26 GMT
> * expire date: 2035-02-13 07:02:26 GMT
> * common name: localhost (matched)
> * issuer: C=US; ST=CA; L=Mountain View; O=WSO2; CN=localhost
> * SSL certificate verify result: unable to get local issuer certificate
> (20), continuing anyway.
> * Server auth using Basic with user 'admin'
> > POST /api/applications/single-cartridge-app/signup HTTP/1.1
> > Authorization: Basic YWRtaW46YWRtaW4=
> > User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0
> OpenSSL/0.9.8| zlib/1.2.5
> > Host: localhost:9443
> > Accept: */*
> > Content-Type: application/json
> > Content-Length: 428
> >
> * upload completely sent off: 428 out of 428 bytes
> < HTTP/1.1 200 OK
> < Date: Tue, 31 Mar 2015 10:08:58 GMT
> < Content-Type: application/json
> < Transfer-Encoding: chunked
> < Server: WSO2 Carbon Server
> <
> * Connection #0 to host localhost left intact
> {"statusCode":200,"successMessage":"Successfully signed up for:
> [application] single-cartridge-app"}* Closing connection #0
>
>
>
> Regards,
> Mariangela
>
>
>
>
> *--*
> Mariangela Hills
> Senior Technical Writer
>
> *WSO2, Inc.*lean.enterprise.middleware.
>
> --
> Thanks and Regards,
>
> Isuru H.
> +94 716 358 048* <http://wso2.com/>*
>
>
> * <http://wso2.com/>*
>
>
>