-
Notifications
You must be signed in to change notification settings - Fork 4
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
10 changed files
with
367 additions
and
447 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
Crystal Controller API Specification | ||
==================================== | ||
**Table of Contents** | ||
|
||
- [Common aspects](#common-aspects) | ||
- [Error handling](#error-handling) | ||
- [Authentication](#authentication) | ||
- [API specification](#api-specification) | ||
|
||
## Common aspects | ||
|
||
### Error handling | ||
|
||
Errors are returned using standard HTTP error code syntax. Any additional info is included in the body of the return call, JSON-formatted. Error codes not listed here are in the REST API methods listed below. | ||
|
||
Standard API errors | ||
|
||
CODE | DESCRIPTION | ||
--- | --- | ||
**400** | Bad input parameter. Error message should indicate which one and why. | ||
**401** | Authorization required. The presented credentials, if any, were not sufficient to access the folder resource. Returned if an application attempts to use an access token after it has expired. | ||
**403** | Forbidden. The requester does not have permission to access the specified resource. | ||
**404** | File or folder not found at the specified path. | ||
**405** | Request method not expected (generally should be GET or POST). | ||
**5xx** | Server error | ||
|
||
### Authentication | ||
|
||
After successfully receiving the credentials from keystone, it is necessary that all API calls will be authenticated. To authenticate the calls, it needs to add the header explained in the next table: | ||
|
||
OAuth PARAMETER | DESCRIPTION | ||
--- | --- | ||
**X-Auth-Token** | Admin token obtained after a successful authentication in keystone. | ||
|
||
## API specification | ||
|
||
The Crystal Controller API structures the allowed operations in different groups: | ||
|
||
- [BW operations](/doc/api_specification_bw.md) | ||
- [Filters operations](/doc/api_specification_filters.md) | ||
- [Registry operations](/doc/api_specification_registry.md) | ||
- [Swift operations](/doc/api_specification_swift.md) |
Oops, something went wrong.