Validate Entitlement Request Data
POSThttps://example.saviyntcloud.com/ECM/api/v5/validateEntitlementRequestData
This API checks if a user is allowed to request for the entitlements given in a list based on the existing access and entitlement map exclusion.
The Authorization
must have Bearer
followed by Token
.
Mandatory params:
username
,
endpoint
,
entitlementList
- List of entitlementtypes and entitlements that needs to be checked.
Optional params:
includeinflightrequests
- If includeinflightrequests
is true, API will also consider Entitlement requests in flight (requests that are submitted but not yet approved/rejected).
Request
- application/json
Body
endpointstring
Example:
System1
entitlementList
object[]
includeinflightrequestsstring
Example:
true
usernamestring
Example:
188836
Responses
- 200
Validate Entitlement RequestData
Response Headers
- application/json
- Schema
- Example (from schema)
- Validate Entitlement RequestData
Schema
endpointstring
Example:
System1
errorCodestring
Example:
1
messagestring
Example:
Failure
usernamestring
Example:
188836
validationResults
object[]
{
"endpoint": "System1",
"errorCode": "1",
"message": "Failure",
"username": "188836",
"validationResults": [
{
"entitlementtype": "Access",
"entitlementvalue": "Analyst",
"requestable": "1"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Accountant",
"failurereason": "Entitlement already assigned to User",
"requestable": "0"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Absence Calculations Administrator",
"failurereason": "Entitlement already requested",
"requestable": "0"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Absence Partner",
"failurereason": "Excluded Entitlement for an Entitlement already requested",
"requestable": "0"
},
{
"entitlementtype": "Access",
"entitlementvalue": "AM: Admin",
"failurereason": "Excluded Entitlement",
"requestable": "0"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Action Plan Owner Group111",
"failurereason": "Invalid Entitlement",
"requestable": "0"
},
{
"entitlementtype": "Access111",
"entitlementvalue": "Action Plan Owner Group",
"failurereason": "Invalid Entitlement",
"requestable": "0"
}
]
}
{
"endpoint": "System1",
"errorCode": "1",
"message": "Failure",
"username": "188836",
"validationResults": [
{
"entitlementtype": "Access",
"entitlementvalue": "Analyst",
"requestable": "1"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Accountant",
"failurereason": "Entitlement already assigned to User",
"requestable": "0"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Absence Calculations Administrator",
"failurereason": "Entitlement already requested",
"requestable": "0"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Absence Partner",
"failurereason": "Excluded Entitlement for an Entitlement already requested",
"requestable": "0"
},
{
"entitlementtype": "Access",
"entitlementvalue": "AM: Admin",
"failurereason": "Excluded Entitlement",
"requestable": "0"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Action Plan Owner Group111",
"failurereason": "Invalid Entitlement",
"requestable": "0"
},
{
"entitlementtype": "Access111",
"entitlementvalue": "Action Plan Owner Group",
"failurereason": "Invalid Entitlement",
"requestable": "0"
}
]
}
Authorization: http
name: bearerAuthtype: httpscheme: bearerbearerFormat: JWT
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L 'https://example.saviyntcloud.com/ECM/api/v5/validateEntitlementRequestData' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <token>' \
-d '{
"endpoint": "System1",
"entitlementList": [
{
"entitlementtype": "Access",
"entitlementvalue": "Analyst"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Accountant"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Absence Calculations Administrator"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Absence Partner"
},
{
"entitlementtype": "Access",
"entitlementvalue": "AM: Admin"
},
{
"entitlementtype": "Access",
"entitlementvalue": "Action Plan Owner Group111"
},
{
"entitlementtype": "Access111",
"entitlementvalue": "Action Plan Owner Group"
}
],
"includeinflightrequests": "true",
"username": "188836"
}'
ResponseClear