SlideShare ist ein Scribd-Unternehmen logo
1 von 51
Downloaden Sie, um offline zu lesen
SEGAP REST API 1.0

1. Assumptions
2. Base URL
{segap_host}/segap/{version}
GET
3. Authorization
{base}/authorization/login
POST
{base}/authorization/logout
POST
{base}/authorization/oauth2.0/authorize
GET
{base}/authorization/oauth2.0/token
POST
4. Administration
{base}/users
POST
{base}/users/{user_id}
PUT
DELETE
GET
{base}/games
POST
{base}/games/{game_id}
PUT
DELETE
GET
{base}/games/{game_id}/themes
POST
GET
DELETE
{base}/games/{game_id}/themes/{theme_id}
DELETE
GET
{base}/games/{game_id}/themes/{theme_id}/entities
POST
DELETE
GET
1
{base}/games/{game_id}/themes/{theme_id}/entities/{entity_id}
PUT
DELETE
GET
{base}/games/{game_id}/themes/{theme_id}/variables
POST
DELETE
GET
{base}/games/{game_id}/themes/{theme_id}/variables/{variable_id}
PUT
DELETE
GET
{base}/games/{game_id}/themes/{theme_id}/actions
POST
DELETE
GET
{base}/games/{game_id}/themes/{theme_id}/actions/{action_id}
PUT
DELETE
GET
{base}/games/{game_id}/themes/{theme_id}/conditions
POST
DELETE
GET
{base}/games/{game_id}/themes/{theme_id}/conditions/{condition_id}
PUT
DELETE
GET
{base}/games/{game_id}/tips
POST
DELETE
GET
{base}/games/{game_id}/tips/{tip_id}
PUT
DELETE
GET
{base}/themes
POST
{base}/themes/{theme_id}
PUT
DELETE
GET
{base}/themes/{theme_id}/entities
2
POST
DELETE
GET
{base}/themes/{theme_id}/entities/{entity_id}
PUT
DELETE
GET
{base}/themes/{theme_id}/variables
POST
DELETE
GET
{base}/themes/{theme_id}/variables/{variable_id}
PUT
DELETE
GET
{base}/themes/{theme_id}/actions
POST
DELETE
GET
{base}/themes/{theme_id}/actions/{action_id}
PUT
DELETE
GET
{base}/themes/{theme_id}/conditions
POST
DELETE
GET
{base}/themes/{theme_id}/conditions/{condition_id}
PUT
DELETE
GET
5. REST API Client data collection
{base}/users/{user_id}/games
POST
DELETE
GET
{base}/users/{user_id}/games/{game_id}/themes/{theme_id}/entities
GET
{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/entities/{entity_id}
PUT
GET
{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/variables
GET
3
{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/variables/{variable_id}
PUT
GET
{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/actions
GET
{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/actions/{action_id}
PUT
GET
{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/conditions
GET
{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/conditions/{condition_id}
PUT
GET
{base}/users/{user_id}/games/{game_id}/history
POST
GET
{base}/users/{user_id}/games/{game_id}/history/{date}
GET
6. SPARQL dataset (rdf files, the rdf database)
{base}/users
GET
{base}/games
GET
{base}/themes
GET
7. SPARQL endpoint
{base}/sparql
POST

1. Assumptions

2. Base URL
segap_host = this the location on the web where SEGAP is hosted, ex: http://www.iamahost.org
version = this indicates the version of SEGAP API

4
url

{segap_host}/segap/{version}

method

GET

parameters

OAuth2.0 related stuff: access_token ­ a token which can be used to make
calls to the SEGAP REST API; token_type ­ the type of the token, values:
game, supplier, administrator; user_id ­ the SEGAP user ID of the authorized
user.

content

Not required.

http codes

200 OK ­ standard response for successful HTTP requests
404 Not found ­ requested resource could not be found
405 Method not supported ­ request method not supported by that resource
500 Internal server error ­ server error message describing the error

returns

It returns details about the SEGAP indicated {version} in a RDF/XML format.

base = {segap_host}/segap/1.0
The {base} notation will be used through the rest of the API URL specification to reduce the
amount of text required for the services URL representation and make the significant part more
visible. Notice the 1.0, this is the value of the {version} that we use for the current API
specification, meaning SEGAP REST API Version 1.0.

3. Authorization
The following services are used for basic authorization purposes regarding the user.
url

{base}/authorization/login

method

POST

parameters

user_id ­ (required) The unique user id user to identify the account.
password ­ (required) Hashed/salted password corresponding to the account.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a session for the user and other user related task and information.
5
url

{base}/authorization/logout

method

POST

parameters

No parameters required.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It terminates the user session and user session related tasks.

These next services are related only to OAuth2.0, that is used to provide game clients a way to
gain access to resources without gaining access to the user password or other private secure
data.
url

{base}/authorization/oauth2.0/authorize

method

GET

parameters

response_type ­ (required) The grant type requested, either token or code.
client_id ­ (required) The client id that is making the request.
redirect_uri ­ Where to redirect the user after authorization has completed. A
redirect URI is required for a token flow, but optional for code. If the redirect URI
is omitted, the code will be presented directly to the user and they will be invited
to enter the information in the client.

content

Not required.

http codes

200 OK ­ standard response for successful HTTP requests
404 Not found ­ requested resource could not be found
405 Method not supported ­ request method not supported by that resource
500 Internal server error ­ server error message describing the error

returns

There is no direct return value. However, after the user authorizes the client,
they will be sent to your redirect URI.
Code flow:
­ parameter passed in the query string (after the ? in the URL):
1. code ­ the authorization code, which can be used to attain a bearer
token by calling {base}/authorization/oauth2.0/token.
­ example: {redirect_uri}?code=jskajsueu12bdj
6
Token flow:
­ these parameters are passed in the URL fragment (after the # in the URL):
1. access_token ­ a token which can be used to make calls to the
SEGAP REST API;
2. token_type ­ the type of the token, values: game, supplier,
administrator;
3. user_id ­ the SEGAP user ID of the authorized user.
­ example:
{redirect_uri}#access_token=jskajsueu12bdj&token_type=game&user_id=y2k
In either flow, if an error occurs, including if the user has chosen not to
authorize the app, the following parameters will be included in the redirect URI:
1. error ­ an error code per Section 4.1.2.1 of the OAuth 2.0 spec;
2. error_description ­ a user­friendly description of the error that
occurred.
description

Provides authorize support as per RFC 6749 OAuth2.0 specifications.

url

{base}/authorization/oauth2.0/token

method

POST

parameters

code ­ (required) The code acquired by directing users to
{base}/oauth2.0/authorize?response_type=code.
grant_type ­ (required) The grant type, which must be authorization_code.
client_id ­ (required) The client unique identifier.
client_secret ­ (required) This is the client secret.
redirect_uri ­ Only used to validate that it matches the original
{base}/oauth2.0/authorize, not used to redirect again.

content

Not required.

http codes

200 OK ­ standard response for successful HTTP requests
404 Not found ­ requested resource could not be found
405 Method not supported ­ request method not supported by that resource
500 Internal server error ­ server error message describing the error

returns

It returns information including an access token (access_token), token type
(token_type), and SEGAPuser ID (user_id). This info is presented in RDF/XML
format.

description

Provides token support as per RFC 6749 OAuth2.0 specifications.

4. Administration

7
These services are not called during a game, they are present only for the resource
management.
The following services are used for account manipulation operations. These services are also
used in order to supply various user related information that will be used for RDF SPARQL
related tasks.
url

{base}/users

method

POST

parameters

user_id ­ (required) The unique user id user to identify the account.
password ­ (required) Hashed/salted password corresponding to the account.

content

application/rdf+xml ­ User related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a new user in the system. There are three account types: player,
supplier and administrator.
The player account can be created by anyone, it is the most basic account
type, the one that plays games.
The supplier account type can only be create by an administrator account.
This account can add games to the system.
The administrator account type can be created only by other administrator
accounts. He manages the themes and theme related information and it also
have full right in managing other kind of accounts and tasks.

url

{base}/users/{user_id}

method

PUT

parameters

new_password ­ Hashed/salted new password corresponding to the account.

content

application/rdf+xml ­ User related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
8
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.
returns

It does not return anything special.

description

It updates user information already present in the system.

url

{base}/users/{user_id}

method

DELETE

parameters

password ­ (required) Hashed/salted password corresponding to the account.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes user information already present in the system.

url

{base}/users/{user_id}

method

GET

parameters

No parameters are required.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ User related information.

description

It retrieves user information already present in the system.

The following services are used to supply and manage game related information such as the
theme of the game and game theme(template) related information.
9
url

{base}/games

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Game related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a new game and it adds it to the system.

url

{base}/games/{game_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Game related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a game resource already present in the system.

url

{base}/games/{game_id}

method

DELETE
10
parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes a game resource already present in the system.

url

{base}/games/{game_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Game related information.

description

It provides information about a game resource already present in the system.

The following services are related to the game specifics such as the theme and mechanics.

url

{base}/games/{game_id}/themes

method

POST

11
parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It associates an existing theme with the current game.

url

{base}/games/{game_id}/themes

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Information about all the themes in regard with what is
used from those themes in the current game.

description

It provides information about all the theme resources associated with the game.

url

{base}/games/{game_id}/themes

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
12
authorized user.
content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes all of the themes associated with the game.

url

{base}/games/{game_id}/themes/{theme_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes association with an existing, already associated theme with the
current game.

url

{base}/games/{game_id}/themes/{theme_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

13
http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme related information in regard with what is used
from that theme in the current game.

description

It provides information about a theme resource associated with the game.

url

{base}/games/{game_id}/themes/{theme_id}/entities

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme entity related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates an entity from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/entities

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
14
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.
returns

It does not return anything special.

description

It removes all of the entities created from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/entities

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme entities related information.

description

It returns all of the entities created from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/entities/{entity_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme entity related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

15
returns

It does not return anything special.

description

It updates an entity from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/entities/{entity_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes an entity from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/entities/{entity_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme entity related information.

description

It returns the entity from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/variables
16
method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme variable related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a variable from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/variables

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes all of the variables created from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/variables

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
17
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.
content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme variables related information.

description

It returns all of the variables created from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/variables/{variable_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme variable related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a variable from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/variables/{variable_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.
18
http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes a variable from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/variables/{variable_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme variable related information.

description

It returns variable information from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/actions

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme action related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
19
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.
returns

It does not return anything special.

description

It creates an action from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/actions

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes all of the actions created from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/actions

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme actions related information.

20
description

It returns all of the actions created from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/actions/{action_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme action related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates an action from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/actions/{action_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes an action from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/actions/{action_id}

21
method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme action related information.

description

It returns action information from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/conditions

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme condition related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a condition from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/conditions

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
22
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.
content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes all of the conditions created from the associated theme for the
game.

url

{base}/games/{game_id}/themes/{theme_id}/conditions

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme conditions related information used by the game.

description

It returns all of the conditions created from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/conditions/{condition_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme action related information.
23
http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a condition from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/conditions/{condition_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes a condition from the associated theme for the game.

url

{base}/games/{game_id}/themes/{theme_id}/conditions/{condition_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
24
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.
returns

application/rdf+xml ­ Theme condition related information.

description

It returns condition information from the associated theme for the game.

url

{base}/games/{game_id}/tips

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Game tip related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a tip for the game.

url

{base}/games/{game_id}/tips

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.
25
description

It removes all of the tips created from the game.

url

{base}/games/{game_id}/tips

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Game tips related information.

description

It returns all of the tips created for the game.

url

{base}/games/{game_id}/tips/{tip_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Game tip related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a tip from the game.

url

{base}/games/{game_id}/tips/{tip_id}

26
method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes a tip from the game.

url

{base}/games/{game_id}/tips/{tip_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Game tip related information.

description

It returns tip information from the game.

The following services are related with defining game thematics that the games will use to better
describe their standing point regarding the category they are in specifics such as actions,
parameters, condition and variables.

27
url

{base}/themes

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a game theme.

url

{base}/themes/{theme_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Game theme related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a theme with information.

url

{base}/themes/{theme_id}

method

DELETE
28
parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes a theme from the system.

url

{base}/themes/{theme_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme related information.

description

It returns theme information from the system.

url

{base}/themes/{theme_id}/entities

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

29
content

application/rdf+xml ­ Theme entity related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates an entity template for the current theme.

url

{base}/themes/{theme_id}/entities

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes all of entities created for the theme.

url

{base}/themes/{theme_id}/entities

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
30
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.
returns

application/rdf+xml ­ Game tips related information.

description

It returns all of the entities created for the current theme.

url

{base}/themes/{theme_id}/entities/{entity_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme entity related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates an entity for a theme in the system.

url

{base}/themes/{theme_id}/entities/{entity_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.
31
returns

It does not return anything special.

description

It removes an entity from the current theme.

url

{base}/theme/{theme_id}/entities/{entity_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme entity related information.

description

It returns information about an entity from the current theme.

url

{base}/themes/{theme_id}/variables

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme entity related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a variable template information for the current theme.

32
url

{base}/themes/{theme_id}/variables

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes all of variables templates created for the theme.

url

{base}/themes/{theme_id}/variables

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Variables templates related information.

description

It returns all of the variable templates created for the current theme.

url

{base}/themes/{theme_id}/variables/{variable_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
33
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.
content

application/rdf+xml ­ Theme variable template related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a variable template for the current theme.

url

{base}/themes/{theme_id}/variables/{variable_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes a variable template from the current theme.

url

{base}/theme/{theme_id}/variables/{variable_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

34
content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme variable template related information.

description

It returns information about a variable template from the current theme.

url

{base}/themes/{theme_id}/actions

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme action template related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates an action template information for the current theme.

url

{base}/themes/{theme_id}/actions

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
35
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.
returns

It does not return anything special.

description

It removes all of actions templates created for the theme.

url

{base}/themes/{theme_id}/actions

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Action templates related information.

description

It returns information for all of the action templates created for the current
theme.

url

{base}/themes/{theme_id}/actions/{action_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme action template related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
36
500 Internal server error ­ Server error message describing the error.
returns

It does not return anything special.

description

It updates an action template for the current theme.

url

{base}/themes/{theme_id}/actions/{action_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes an action template from the current theme.

url

{base}/theme/{theme_id}/actions/{action_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme action template related information.

description

It returns information about an action template from the current theme.
37
url

{base}/themes/{theme_id}/conditions

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme condition template related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It creates a condition template information for the current theme.

url

{base}/themes/{theme_id}/conditions

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes all of the condition templates created for the theme.

url

{base}/themes/{theme_id}/conditions

method

GET

38
parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Condition templates related information.

description

It returns information for all of the condition templates created for the current
theme.

url

{base}/themes/{theme_id}/conditions/{condition_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme condition template related information.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a condition template for the current theme.

url

{base}/themes/{theme_id}/conditions/{condition_id}

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
39
authorized user.
content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes a condition template from the current theme.

url

{base}/theme/{theme_id}/conditions/{condition_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Theme condition template related information.

description

It returns information about a condition template from the current theme.

5. REST API Client data collection
These services are used by the client to provide information about an ongoing game to SEGAP.

url

{base}/users/{user_id}/games

method

POST

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
40
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.
content

application/rdf+xml ­ Game related information.

http codes

201 resource created ­ Request has been fulfilled; new resource created.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It associates a game with the current user.

url

{base}/users/{user_id}/games

method

DELETE

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It removes all of the games associated with the user.

url

{base}/users/{user_id}/games

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

41
content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Action templates related information.

description

It returns information for all of the games associated with the current user.

url

{base}/users/{user_id}/games/{game_id}/themes/{theme_id}/entities

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Entities related information.

description

It  return informations about all entities used in the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/entities/{entit
y_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme entity information for the current game.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
42
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.
returns

It does not return anything special.

description

It updates an entity for the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/entities/{entit
y_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Entity related information.

description

It retrieves information about an entity from the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/variables

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
43
500 Internal server error ­ Server error message describing the error.
returns

application/rdf+xml ­ Variables related information.

description

It  returns informations about all variables used in the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/variables/{var
iable_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme variable information for the current game.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a variable for the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/variables/{var
iable_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

44
returns

application/rdf+xml ­ Variable related information.

description

It retrieves information about a variable from the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/actions

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Actions related information.

description

It returns informations about all actions used in the current game for the
indicated theme.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/actions/{actio
n_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme action information for the current game.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

45
description

It updates an action for the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/action/{action
_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Action related information.

description

It retrieves information about an action from the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/conditions

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Conditions related information.

description

It returns informations about all conditions used in the current game for the
indicated theme.

46
url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/conditions/{c
ondition_id}

method

PUT

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

application/rdf+xml ­ Theme condition information for the current game.

http codes

200 OK ­ Standard response for successful HTTP requests.
400 Bad request ­ The request cannot be fulfilled due to bad syntax.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

It does not return anything special.

description

It updates a condition for the current game.

url

{base}/users/{user_id}/games/{game_id}/theme/{theme_id}/conditions/{c
ondition_id}

method

GET

parameters

OAuth 2.0 related parameters: access_token ­ a token which can be used to
make calls to the SEGAP REST API; token_type ­ the type of the token,
values: game, supplier, administrator; user_id ­ the SEGAP user ID of the
authorized user.

content

Not required.

http codes

200 OK ­ Standard response for successful HTTP requests.
401 Unauthorized ­ Authentication is possible but has failed.
403 Forbidden ­ Server refuses/not allowing to respond/fulfill a request.
404 Not found ­ Requested resource could not be found.
405 Method not supported ­ Request method not supported by that resource.
500 Internal server error ­ Server error message describing the error.

returns

application/rdf+xml ­ Condition related information.

description

It retrieves information about a condition from the current game.

url

{base}/users/{user_id}/games/{game_id}/history

47
SegapRESTAPI1.0 specifications
SegapRESTAPI1.0 specifications
SegapRESTAPI1.0 specifications
SegapRESTAPI1.0 specifications

Weitere ähnliche Inhalte

Andere mochten auch (9)

2013 GLC Annual Meeting brochure
2013 GLC Annual Meeting brochure2013 GLC Annual Meeting brochure
2013 GLC Annual Meeting brochure
 
SEGAP-General resource information
SEGAP-General resource informationSEGAP-General resource information
SEGAP-General resource information
 
2 Day Mahara User Training
2 Day Mahara User Training 2 Day Mahara User Training
2 Day Mahara User Training
 
Web browser game development(pre)
Web browser game development(pre)Web browser game development(pre)
Web browser game development(pre)
 
Web browser game development(lncs)
Web browser game development(lncs)Web browser game development(lncs)
Web browser game development(lncs)
 
Estructura de la terra
Estructura de la terraEstructura de la terra
Estructura de la terra
 
GLC Annual Celebration 2015 brochure
GLC Annual Celebration 2015 brochureGLC Annual Celebration 2015 brochure
GLC Annual Celebration 2015 brochure
 
SEGAP - Technical overview
SEGAP - Technical overviewSEGAP - Technical overview
SEGAP - Technical overview
 
Segap project(lncs)
Segap project(lncs)Segap project(lncs)
Segap project(lncs)
 

Ähnlich wie SegapRESTAPI1.0 specifications

WordPress Hidden Gems (July 2011)
WordPress Hidden Gems (July 2011)WordPress Hidden Gems (July 2011)
WordPress Hidden Gems (July 2011)
Stephanie Leary
 
Parse - a mobile backend platform
Parse - a mobile backend platformParse - a mobile backend platform
Parse - a mobile backend platform
Carlotta Tatti
 
I really need some help if I have this right so far. PLEASE CHANG.pdf
I really need some help if I have this right so far. PLEASE CHANG.pdfI really need some help if I have this right so far. PLEASE CHANG.pdf
I really need some help if I have this right so far. PLEASE CHANG.pdf
aggarwalshoppe14
 
Thanks so much for your help. Review the GameService class. Noti.pdf
Thanks so much for your help. Review the GameService class. Noti.pdfThanks so much for your help. Review the GameService class. Noti.pdf
Thanks so much for your help. Review the GameService class. Noti.pdf
adwitanokiastore
 
I really need some help if I have this right so far. Please Resub.pdf
I really need some help if I have this right so far. Please Resub.pdfI really need some help if I have this right so far. Please Resub.pdf
I really need some help if I have this right so far. Please Resub.pdf
aggarwalshoppe14
 
Jersey framework
Jersey frameworkJersey framework
Jersey framework
knight1128
 

Ähnlich wie SegapRESTAPI1.0 specifications (20)

Great Developers Steal
Great Developers StealGreat Developers Steal
Great Developers Steal
 
XamarinとAWSをつないでみた話
XamarinとAWSをつないでみた話XamarinとAWSをつないでみた話
XamarinとAWSをつないでみた話
 
Foundations of a Social Application Platform
Foundations of a Social Application PlatformFoundations of a Social Application Platform
Foundations of a Social Application Platform
 
WordPress Hidden Gems (July 2011)
WordPress Hidden Gems (July 2011)WordPress Hidden Gems (July 2011)
WordPress Hidden Gems (July 2011)
 
apidays LIVE LONDON - Data Retrieval via APIs - Showdown of GraphQL vs ODATA ...
apidays LIVE LONDON - Data Retrieval via APIs - Showdown of GraphQL vs ODATA ...apidays LIVE LONDON - Data Retrieval via APIs - Showdown of GraphQL vs ODATA ...
apidays LIVE LONDON - Data Retrieval via APIs - Showdown of GraphQL vs ODATA ...
 
APIDOC In A Nutshell
APIDOC In A NutshellAPIDOC In A Nutshell
APIDOC In A Nutshell
 
Api design and usability
Api design and usabilityApi design and usability
Api design and usability
 
Mashing up JavaScript
Mashing up JavaScriptMashing up JavaScript
Mashing up JavaScript
 
Mashing up JavaScript – Advanced Techniques for modern Web Apps
Mashing up JavaScript – Advanced Techniques for modern Web AppsMashing up JavaScript – Advanced Techniques for modern Web Apps
Mashing up JavaScript – Advanced Techniques for modern Web Apps
 
Shibboleth 2.0 SP slides - Installfest
Shibboleth 2.0 SP slides - InstallfestShibboleth 2.0 SP slides - Installfest
Shibboleth 2.0 SP slides - Installfest
 
Parse - a mobile backend platform
Parse - a mobile backend platformParse - a mobile backend platform
Parse - a mobile backend platform
 
I really need some help if I have this right so far. PLEASE CHANG.pdf
I really need some help if I have this right so far. PLEASE CHANG.pdfI really need some help if I have this right so far. PLEASE CHANG.pdf
I really need some help if I have this right so far. PLEASE CHANG.pdf
 
Thanks so much for your help. Review the GameService class. Noti.pdf
Thanks so much for your help. Review the GameService class. Noti.pdfThanks so much for your help. Review the GameService class. Noti.pdf
Thanks so much for your help. Review the GameService class. Noti.pdf
 
I really need some help if I have this right so far. Please Resub.pdf
I really need some help if I have this right so far. Please Resub.pdfI really need some help if I have this right so far. Please Resub.pdf
I really need some help if I have this right so far. Please Resub.pdf
 
SP Rest API Documentation
SP Rest API DocumentationSP Rest API Documentation
SP Rest API Documentation
 
Twitter codeigniter library
Twitter codeigniter libraryTwitter codeigniter library
Twitter codeigniter library
 
Jersey framework
Jersey frameworkJersey framework
Jersey framework
 
Jsp presentation
Jsp presentationJsp presentation
Jsp presentation
 
We sport architecture_implementation
We sport architecture_implementationWe sport architecture_implementation
We sport architecture_implementation
 
RESTFul API Design and Documentation - an Introduction
RESTFul API Design and Documentation - an IntroductionRESTFul API Design and Documentation - an Introduction
RESTFul API Design and Documentation - an Introduction
 

Kürzlich hochgeladen

+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
?#DUbAI#??##{{(☎️+971_581248768%)**%*]'#abortion pills for sale in dubai@
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Safe Software
 

Kürzlich hochgeladen (20)

Top 5 Benefits OF Using Muvi Live Paywall For Live Streams
Top 5 Benefits OF Using Muvi Live Paywall For Live StreamsTop 5 Benefits OF Using Muvi Live Paywall For Live Streams
Top 5 Benefits OF Using Muvi Live Paywall For Live Streams
 
A Domino Admins Adventures (Engage 2024)
A Domino Admins Adventures (Engage 2024)A Domino Admins Adventures (Engage 2024)
A Domino Admins Adventures (Engage 2024)
 
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
Connector Corner: Accelerate revenue generation using UiPath API-centric busi...
 
Exploring the Future Potential of AI-Enabled Smartphone Processors
Exploring the Future Potential of AI-Enabled Smartphone ProcessorsExploring the Future Potential of AI-Enabled Smartphone Processors
Exploring the Future Potential of AI-Enabled Smartphone Processors
 
Partners Life - Insurer Innovation Award 2024
Partners Life - Insurer Innovation Award 2024Partners Life - Insurer Innovation Award 2024
Partners Life - Insurer Innovation Award 2024
 
Automating Google Workspace (GWS) & more with Apps Script
Automating Google Workspace (GWS) & more with Apps ScriptAutomating Google Workspace (GWS) & more with Apps Script
Automating Google Workspace (GWS) & more with Apps Script
 
GenAI Risks & Security Meetup 01052024.pdf
GenAI Risks & Security Meetup 01052024.pdfGenAI Risks & Security Meetup 01052024.pdf
GenAI Risks & Security Meetup 01052024.pdf
 
AWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of TerraformAWS Community Day CPH - Three problems of Terraform
AWS Community Day CPH - Three problems of Terraform
 
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot TakeoffStrategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
Strategize a Smooth Tenant-to-tenant Migration and Copilot Takeoff
 
Tata AIG General Insurance Company - Insurer Innovation Award 2024
Tata AIG General Insurance Company - Insurer Innovation Award 2024Tata AIG General Insurance Company - Insurer Innovation Award 2024
Tata AIG General Insurance Company - Insurer Innovation Award 2024
 
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law DevelopmentsTrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
TrustArc Webinar - Stay Ahead of US State Data Privacy Law Developments
 
Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...Apidays New York 2024 - The value of a flexible API Management solution for O...
Apidays New York 2024 - The value of a flexible API Management solution for O...
 
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
Apidays Singapore 2024 - Building Digital Trust in a Digital Economy by Veron...
 
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
+971581248768>> SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHA...
 
2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...2024: Domino Containers - The Next Step. News from the Domino Container commu...
2024: Domino Containers - The Next Step. News from the Domino Container commu...
 
Boost PC performance: How more available memory can improve productivity
Boost PC performance: How more available memory can improve productivityBoost PC performance: How more available memory can improve productivity
Boost PC performance: How more available memory can improve productivity
 
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers:  A Deep Dive into Serverless Spatial Data and FMECloud Frontiers:  A Deep Dive into Serverless Spatial Data and FME
Cloud Frontiers: A Deep Dive into Serverless Spatial Data and FME
 
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data DiscoveryTrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
TrustArc Webinar - Unlock the Power of AI-Driven Data Discovery
 
presentation ICT roal in 21st century education
presentation ICT roal in 21st century educationpresentation ICT roal in 21st century education
presentation ICT roal in 21st century education
 
Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024Axa Assurance Maroc - Insurer Innovation Award 2024
Axa Assurance Maroc - Insurer Innovation Award 2024
 

SegapRESTAPI1.0 specifications