Coruson API

<back to all web services

GetRiskMatrices

Coruson Risk

Requires Authentication
The following routes are available for this service:
GET/api/risks/riskmatricesQuery for Coruson Risk Matrices
GetRiskMatrices Parameters:
NameParameterData TypeRequiredDescription
ReportIdqueryGuidNoOptional. When supplied, only risk matrices configured/available for this report are returned.
OrderByqueryMatrixOrderYesProperty to order by in Ascending order. Default is 'Name'.

Allowable Values

  • Default
  • Name
OrderByDescqueryMatrixOrderYesProperty to order by in Descending order.

Allowable Values

  • Default
  • Name
ThenByqueryMatrixOrderYesSecond Property to order by in Ascending order. NOTE: If this value is the same as either the OrderBy or OrderByDesc values, then it will be ignored.

Allowable Values

  • Default
  • Name
ThenByDescqueryMatrixOrderYesSecond Property to order by in Descending order. NOTE: If this value is the same as either the OrderBy or OrderByDesc values, then it will be ignored.

Allowable Values

  • Default
  • Name
PagingRequestBase<T> Parameters:
NameParameterData TypeRequiredDescription
SkipformIntegerNoNumber of items to skip before returning results. Minimum suitable value is 0 and is also the default value.
TakeformIntegerNoNumber of items to return per page. Must be a number in the range 1-100. Default value is 100.
OrderByformEnumNoOrder By
OrderByDescformEnumNoOrder By Descending
ThenByformEnumNoThen By
ThenByDescformEnumNoThen By Descending
RequestBase Parameters:
NameParameterData TypeRequiredDescription
VersionformintNo
GetRiskMatricesResponse Parameters:
NameParameterData TypeRequiredDescription
RiskMatricesformList<RiskMatrix>No
GetResponseBase Parameters:
NameParameterData TypeRequiredDescription
TotalResultsformintNo
SkipformintNo
TakeformintNo
LinksformList<Link>No
ResponseBase Parameters:
NameParameterData TypeRequiredDescription
StatusDescriptionformstringNo
ResponseStatusformResponseStatusNo
Link Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
RequestUrlformstringNo
MethodformstringNo
RiskMatrix Parameters:
NameParameterData TypeRequiredDescription
MatrixRevisionIdformGuidNo
MatrixIdformGuidNo
NameformstringNo
DescriptionformstringNo
RevisionformintNo
StatusformMatrixStatusNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

                    POST /jsv/reply/GetRiskMatrices HTTP/1.1 
Host: platform.gaelenlighten.com 
Content-Type: text/jsv
Content-Length: length

{
	Skip: 0,
	Version: 0,
	Take: 0,
	OrderBy: Default,
	OrderByDesc: Default,
	ThenBy: Default,
	ThenByDesc: Default,
	ReportId: 00000000-0000-0000-0000-000000000000
}
                    
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	RiskMatrices: 
	[
		{
			Name: String,
			Description: String,
			Revision: 0,
			Status: Draft
		}
	],
	TotalResults: 0,
	StatusDescription: String,
	Skip: 0,
	ResponseStatus: 
	{
		ErrorCode: String,
		Message: String,
		StackTrace: String,
		Errors: 
		[
			{
				ErrorCode: String,
				FieldName: String,
				Message: String,
				Meta: 
				{
					String: String
				}
			}
		],
		Meta: 
		{
			String: String
		}
	},
	Take: 0,
	Links: 
	[
		{
			Name: String,
			RequestUrl: String,
			Method: String
		}
	]
}