18.01.2015 Views

Content Management Interoperability Services (CMIS) Version 1.1

Content Management Interoperability Services (CMIS) Version 1.1

Content Management Interoperability Services (CMIS) Version 1.1

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

...<br />

<br />

5.2.10 Error Handling and Return Codes<br />

HTTP status codes MUST be used to indicate success or failure of an operation. Please see the HTTP<br />

specification for more information on the HTTP status codes. These are provided as guidance from the<br />

HTTP specification. If any conflict arises, the HTTP specification is authoritative.<br />

<strong>CMIS</strong> <strong>Services</strong> Exception<br />

General Exceptions<br />

invalidArgument 400<br />

notSupported 405<br />

objectNotFound 404<br />

permissionDenied 403<br />

runtime 500<br />

Specific Exceptions<br />

constraint 409<br />

contentAlreadyExists 409<br />

filterNotValid 400<br />

nameConstraintViolation 409<br />

storage 500<br />

streamNotSupported 403<br />

updateConflict 409<br />

versioning 409<br />

HTTP Status Code<br />

This binding also introduces an object to return additional information about the response. <strong>CMIS</strong> repositories<br />

SHOULD include this object in responses. When present, the object MUST include the following JSON<br />

properties.<br />

string exception A string containing one of the <strong>CMIS</strong> services exceptions describe in section 2.2.1.4 Exceptions.<br />

string message A string containing a message that provides more information about what caused the exception.<br />

Example:<br />

GET /cmis/repository/123/myFoldermaxItems=abc HTTP/<strong>1.1</strong><br />

Host: www.example.com<br />

User-Agent: Mozilla/5.0<br />

HTTP/<strong>1.1</strong> 400 Bad Request<br />

<strong>Content</strong>-Type: application/json<br />

<strong>Content</strong>-Length: xxxx<br />

{<br />

}<br />

"exception": "invalidArgument",<br />

"message": "The parameter 'maxItems' is not valid."<br />

If the query parameter suppressResponseCodes=true is set, the repository MUST always return the<br />

HTTP status code 200.<br />

<strong>CMIS</strong>-v<strong>1.1</strong>-csprd01<br />

Standards Track Work Product<br />

Copyright © OASIS Open 2012. All Rights Reserved.<br />

18 August 2012<br />

Page 264 of 331

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!