Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


TCS-AH - ICS API TCS AH API used by ICS-C

Version: 1.0.1

Table of Contents
maxLevel3
minLevel2
include.*
outlinefalse
stylesquare
typelist
printabletrue

Endpoints

datasets

Status
subtlefalse
colourYellow
titleget

...

Summary: Episode dataset
Description: Returns a list of JSON documents containing metadata describing files conained within one of the TCS AH episodes

Parameters

Query Parameters

Name

Description

Required

Default

Pattern

episode

Allows to filter the files by given episode id. May contain multiple values separated by a comma

(tick)



...

after

Allows to filter the files that have the start date metadata set to after the given date. Should be formatted as date-time - RFC3339(

http://xml2rfc.ietf.org/public/rfc/html/rfc3339.html#anchor14

)

(error)



Responses

Status Code: 200
Message: Request was successful. Response contains a list of episode elements (episode file metadata)

Code Block
titleResponse Type

See #models

Code Block
titleResponse Schema
collapsetrue
{
  "description" : "Request was successful. Response contains a list of episode elements (episode file metadata)"
}
        

...

Code Block
titleResponse Type

See #models

Code Block
titleResponse Schema
collapsetrue
{
  "description" : "Invalid time format of 'before' or 'after' parameters"
}
        

...

downloadFile

Status
subtlefalse
colourYellow
titlepost

...

Summary: Download episode file
Description: The operation starts to download the file pointed by the 'fileId'. The header of the request has to contain a valid user authentication token, otherwise the operation would fail.

Parameters

Path Parameters

Name

Description

Required

Default

Pattern

fileId

ID of the file to be download. The ID is displayed within the file metadata (obtained from the /api/epos/episode-elements/ endpoint)

(tick)



Responses

Status Code: 200
Message: The download request was successfull

Code Block
titleResponse Type

See #models

Code Block
titleResponse Schema
collapsetrue
{
  "description" : "The download request was successfull"
}
        

...

Code Block
titleResponse Type

See #models

Code Block
titleResponse Schema
collapsetrue
{
  "description" : "Invalid or missing credentials"
}
        

...

Code Block
titleResponse Type

See #models

Code Block
titleResponse Schema
collapsetrue
{
  "description" : "The file with the specifed ID does not exist"
}
        

...

listApps

Status
subtlefalse
colourYellow
titleget

...

Summary: List of Applications
Description: Returns a list of JSON documents describing the applications integrated within TCS AH. The method allows filtering the list by applying the query criteria.

Parameters

Query Parameters

Name

Description

Required

Default

Pattern

keyword

Allows to filter the returned applications by keywords they declare. May contain multiple values separated by a comma

(error)



...

category

Allows to filter the returned applications by category. May contain multiple values separated by a comma

(error)



Responses

Status Code: 200
Message: Request was successful. Response contains a list of application descriptions matching the query criteria

Code Block
titleResponse Type

See #models

Code Block
titleResponse Schema
collapsetrue
{
  "description" : "Request was successful. Response contains a list of application descriptions matching the query criteria"
}
        

...

listEpisodes

Status
subtlefalse
colourYellow
titleget

...

Summary: List of Episodes
Description: Returns a list of JSON documents describing the episodes integrated within TCS AH. The method allows filtering the list by impacting factor.

Parameters

Query Parameters

Name

Description

Required

Default

Pattern

impactingFactor

Allows to filter the episodes by impacting or inducing factor relevant to the registrations collected into the episode. May contain multiple values separated by a comma

(error)



Responses

Status Code: 200
Message: Request was successful. Response contains a list of episode descriptions matching the query criteria

Code Block
titleResponse Type

See #models

Code Block
titleResponse Schema
collapsetrue
{
  "description" : "Request was successful. Response contains a list of episode descriptions matching the query criteria"
}
        

...

Models