Skip to content
Snippets Groups Projects
Commit b5acf105 authored by Marek Chrastina's avatar Marek Chrastina
Browse files

Manual mdl fix fo test

parent cf32111b
No related branches found
No related tags found
6 merge requests!368Update prace.md to document the change from qprace to qprod as the default...,!367Update prace.md to document the change from qprace to qprod as the default...,!366Update prace.md to document the change from qprace to qprod as the default...,!323extended-acls-storage-section,!196Master,!178Apidocs
Show whitespace changes
Inline Side-by-side
Showing
with 49 additions and 137 deletions
docs.it4i/apidocs.md
+ 49
− 137
View file @ b5acf105
API Documentation_public API Documentation_public
============================================================================================= =============================================================================================
...@@ -11,8 +7,8 @@ Implements API for IT4I SCS Information System. ...@@ -11,8 +7,8 @@ Implements API for IT4I SCS Information System.
- api version: `0.9-11-g9eb0678` - api version: `0.9-11-g9eb0678`
- apidoc building date: `2017-12-08 15:01:48 +0100` - apidoc building date: `2017-12-08 15:01:48 +0100`
Summary Summary
-------------------------------------------------------------- --------------------------------------------------------------
Resource | Operation | Description Resource | Operation | Description
------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------| ----------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------| ----------------------------------------------------------------------------------------------- ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
...@@ -33,42 +29,28 @@ API Details ...@@ -33,42 +29,28 @@ API Details
Request JSON Object: Request JSON Object:
- **login** (*string*) – account id - **login** (*string*) – account id
- **queue** (*string*) – queue id - **queue** (*string*) – queue id
- **pid** (*string*) – project id, not required if querying - **pid** (*string*) – project id, not required if querying projectless queue
projectless queue
Status Codes: Status Codes:
- [200 - [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1)
OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1)
– no error – no error
**Example request**: **Example request**:
curl -i -H "Content-Type:application/json" -X POST \ curl -i -H "Content-Type:application/json" -X POST \
--data '{"pid":"DD-13-5","login":"johnsm","queue":"qfat"}' \ --data '{"pid":"DD-13-5","login":"johnsm","queue":"qfat"}' \
https://scs.it4i.cz/api/v1/check-access https://scs.it4i.cz/api/v1/check-access
**Example response**: **Example response**:
HTTP/1.1 200 OK HTTP/1.1 200 OK
Content-Type: application/json Content-Type: application/json
"OK Access granted for regular queue." "OK Access granted for regular queue."
<!-- -->
`GET /api/v1/dedicated-time/`(*cluster\_type*) {#get--api-v1-dedicated-time-cluster_type} `GET /api/v1/dedicated-time/`(*cluster\_type*) {#get--api-v1-dedicated-time-cluster_type}
: Returns list of times dedicated for HPC maintainance. It is not : Returns list of times dedicated for HPC maintainance. It is not
...@@ -76,8 +58,6 @@ API Details ...@@ -76,8 +58,6 @@ API Details
Query Parameters: Query Parameters:
- **all** – returns all dedicated times for all clusters - **all** – returns all dedicated times for all clusters
- **salomon** – returns all times just for salomon cluster - **salomon** – returns all times just for salomon cluster
- **anselm** – returns all times just for anselm cluster - **anselm** – returns all times just for anselm cluster
...@@ -97,16 +77,10 @@ API Details ...@@ -97,16 +77,10 @@ API Details
**Example request**: **Example request**:
curl -i curl https://scs.it4i.cz/api/v1/dedicated-time/all curl -i curl https://scs.it4i.cz/api/v1/dedicated-time/all
**Example response**: **Example response**:
HTTP/1.1 200 OK HTTP/1.1 200 OK
Content-Type: application/json Content-Type: application/json
...@@ -119,10 +93,6 @@ API Details ...@@ -119,10 +93,6 @@ API Details
} }
] ]
<!-- -->
`POST /api/v1/it4ifree/`(*login*) {#post--api-v1-it4ifree-login} `POST /api/v1/it4ifree/`(*login*) {#post--api-v1-it4ifree-login}
: A service to check resources of the projects on which the account : A service to check resources of the projects on which the account
...@@ -135,24 +105,16 @@ API Details ...@@ -135,24 +105,16 @@ API Details
for more details about so-called normalized core-hours. The json for more details about so-called normalized core-hours. The json
response contains two parts: response contains two parts:
> - `me` – data from projects, where the account has access
> - `me` – data from projects, where the - `me_as_pi` – data from projects, where the account is PI (primary investigator)
> account has access
> - `me_as_pi` – data from projects, where the
> account is PI (primary investigator)
>
Request JSON Object: Request JSON Object:
- **login** (*string*) – account id - **login** (*string*) – account id
- **it4ifreetoken** (*string*) – token - **it4ifreetoken** (*string*) – token
Response JSON Object: Response JSON Object:
- **login** (*string*) – account id - **login** (*string*) – account id
- **pid** (*string*) – project id - **pid** (*string*) – project id
- **pi\_login** (*string*) – account id which is PI - **pi\_login** (*string*) – account id which is PI
...@@ -181,18 +143,12 @@ API Details ...@@ -181,18 +143,12 @@ API Details
**Example request**: **Example request**:
curl -i -H "Content-Type:application/json" -X POST \ curl -i -H "Content-Type:application/json" -X POST \
--data '{"login":"johnsm", "it4ifreetoken": "abc"}' \ --data '{"login":"johnsm", "it4ifreetoken": "abc"}' \
https://scs.it4i.cz/api/v1/it4ifree/johnsm https://scs.it4i.cz/api/v1/it4ifree/johnsm
**Example response**: **Example response**:
HTTP/1.1 200 OK HTTP/1.1 200 OK
Content-Type: application/json Content-Type: application/json
...@@ -239,18 +195,12 @@ API Details ...@@ -239,18 +195,12 @@ API Details
] ]
} }
<!-- -->
`GET /api/v1/motd/`(*category*) {#get--api-v1-motd-category} `GET /api/v1/motd/`(*category*) {#get--api-v1-motd-category}
: Returns SCS messages of the day. : Returns SCS messages of the day.
Query Parameters: Query Parameters:
- **notice** – returns only notice messages - **notice** – returns only notice messages
- **important** – returns only important messages - **important** – returns only important messages
- **all** – returns all messages - **all** – returns all messages
...@@ -266,16 +216,10 @@ API Details ...@@ -266,16 +216,10 @@ API Details
**Example request**: **Example request**:
curl -i https://scs.it4i.cz/api/v1/motd/notice curl -i https://scs.it4i.cz/api/v1/motd/notice
**Example response**: **Example response**:
HTTP/1.1 200 OK HTTP/1.1 200 OK
Content-Type: application/json Content-Type: application/json
...@@ -299,30 +243,19 @@ API Details ...@@ -299,30 +243,19 @@ API Details
} }
] ]
<!-- -->
`GET /api/v1/ping` {#get--api-v1-ping} `GET /api/v1/ping` {#get--api-v1-ping}
: A service for testing connection to API. : A service for testing connection to API.
--------------- ----------------------------------------------------------------------------------------------------------------- Status Codes:
Status Codes: - [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) – no error - [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) – no error
--------------- -----------------------------------------------------------------------------------------------------------------
**Example request**: **Example request**:
curl -i https://scs.it4i.cz/api/v1/ping curl -i https://scs.it4i.cz/api/v1/ping
**Example response**: **Example response**:
HTTP/1.1 200 OK HTTP/1.1 200 OK
Content-Type: application/json Content-Type: application/json
...@@ -330,30 +263,20 @@ API Details ...@@ -330,30 +263,20 @@ API Details
"message": "pong" "message": "pong"
} }
<!-- -->
`GET /api/v1/version` {#get--api-v1-version} `GET /api/v1/version` {#get--api-v1-version}
: Returns basic information about API. : Returns basic information about API.
--------------- ----------------------------------------------------------------------------------------------------------------- Status Codes:
Status Codes: - [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) – no error
--------------- -----------------------------------------------------------------------------------------------------------------
**Example request**:
- [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) – no error
**Example request**:
curl -i https://scs.it4i.cz/api/v1/version curl -i https://scs.it4i.cz/api/v1/version
**Example response**: **Example response**:
HTTP/1.1 200 OK HTTP/1.1 200 OK
Content-Type: application/json Content-Type: application/json
...@@ -363,17 +286,6 @@ API Details ...@@ -363,17 +286,6 @@ API Details
"version": "0.8.2-34-gceac8aa" "version": "0.8.2-34-gceac8aa"
} }
©2017, IT4Innovations. | Powered by [Sphinx ©2017, IT4Innovations. | Powered by [Sphinx
1.5.6](http://sphinx-doc.org/) & [Alabaster 1.5.6](http://sphinx-doc.org/) & [Alabaster
0.7.10](https://github.com/bitprophet/alabaster) 0.7.10](https://github.com/bitprophet/alabaster)
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment