Retrieve a list of gateway security audios
get
/spms/v2/ships/{shipId}/configurations/gatewaySecurity/audios
This is to retrieve a list of gateway security audios.
Request
Supported Media Types
- application/json
Path Parameters
-
shipId(required): number
Ship Id
Query Parameters
-
limit: integer(int32)
Minimum Value:
1Paging limit -
offset: integer(int32)
Minimum Value:
0Paging offset -
orderBy: string
order by audioId, audioTitle, audioFileName, audioUrl with format column1:asc/desc,column2:asc/desc,column3:asc/desc,column4:asc/descDefault Value:
audioTitle:desc
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : Gateway Security Audio Success Oracle Responses list
Type:
objectTitle:
Gateway Security Audio Success Oracle Responses listThe wrapper object when returning successful values in Oracle standard
Show Source
-
count:
number
The total number of items in the list.Example:
22 -
hasMore:
boolean
Flag which indicates whether or not there are more items.Example:
true -
items:
array items
-
limit:
number
Paging limitExample:
5 -
offset:
number
Paging offsetExample:
10
Nested Schema : items
Type:
Show Source
array-
Array of:
object GatewaySecurityAudioConfigurationItems
Gateway Security Audio Items
Example:
[
{
"audioId":100001,
"audioTitle":"GangwayOnboardAllowed",
"audioFileName":"Example Gangway Onboard Allowed.wav",
"audioUrl":"/configurations/gangwaySecuritySounds/100001/sound"
},
{
"audioId":100002,
"audioTitle":"TenderOnboardAllowed",
"audioFileName":"Example Tender Onboard Allowed.wav",
"audioUrl":"/configurations/gangwaySecuritySounds/100002/sound"
}
]Nested Schema : GatewaySecurityAudioConfigurationItems
Type:
objectGateway Security Audio Items
Show Source
-
audioFileName:
string
Minimum Length:
1Maximum Length:300Pattern:^[^\\\/\"\'`=:;<>@+|?*#%&{}$!]+\.[A-Za-z0-9]+$Audio File NameExample:Example Gangway Onboard Allowed.wav -
audioId:
number
Minimum Value:
1Pattern:^[0-9]*$Audio IdExample:100001 -
audioTitle:
string
Minimum Length:
1Maximum Length:500Pattern:^[ A-Za-z0-9,'_@./#&+-]*$Audio TitleExample:GangwayOnboardAllowed -
audioUrl:
string
Audio URLExample:
/configurations/gangwaySecuritySounds/100001/sound
204 Response
No Content
400 Response
Bad Request
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
"title":"Bad Request",
"detail":"The parameter 'shipId' has incorrect format"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
401 Response
Unauthorized
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
"title":"Unauthorized",
"detail":"Valid token is required to access this resource"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
403 Response
Forbidden
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
"title":"Forbidden",
"detail":"You are forbidden to use this API"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
404 Response
Not found
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
"title":"Not Found",
"detail":"Ship Id could not be found"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
405 Response
Method Not Allowed
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
"title":"Method Not Supported",
"detail":"HTTP method not supported for this resource"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
406 Response
Not acceptable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
"title":"Not Acceptable",
"detail":"Request a Mime type that is supported for this Resource"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
415 Response
Unsupported Media Type
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
"title":"Invalid content",
"detail":"Content type not supported"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
500 Response
Internal Server Error
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
"title":"Internal Server Error",
"detail":"Issue fulfilling request. Please retry or contact support"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
501 Response
Not Implemented
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.2",
"title":"Not implemented",
"detail":"Resource is not implemented in this version of the API"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source
503 Response
Service Unavailable
Root Schema : schema
Match All
Show Source
-
object
Error Response
Title:
Error ResponseError Response returned when encountered error
Example:
{
"type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
"title":"Service Unavailable",
"detail":"Service not available"
}Nested Schema : Error Response
Type:
objectTitle:
Error ResponseError Response returned when encountered error
Show Source