The Get Product Details operation will return the detailed information of the specified Self Service product.
Request
Request URI
| Method | Request URI |
|---|---|
| GET | https://{company-name}.helloid.com/api/v1/selfservice/products/{SelfServiceProductGuid} |
| GET | https://{company-name}.helloid.com/api/v1/selfservice/products/{SelfServiceProductCode} |
Request parameters
| Parameter | Description |
|---|---|
| {company-name} | The company name of the target company |
| {SelfServiceProductGuid} | The GUID of the Self Service Product |
| {SelfServiceProductCode} | The code (SKU) of the Self Service Product |
Request headers
None.
Response
Response status
| Code | Description |
|---|---|
| 200(OK) | Indicates that the operation was successful and the resource is created. |
| 400(BAD REQUEST) | Indicates that the operation was not successful. The content type was incorrect or the request body was malformed. |
| 401(UNAUTHORIZED) | Indicates that no authentication header was given or the api key and secret were invalid. If the api key and secret were valid check the configuration in your portal, it is possibilty these were IP restricted or are disabled. |
| 404(NOTFOUND) | Indicates that the the specified no product with the specified GUID or SKU exists.. |
| 409(CONFLICT) | Indicates that the operation was not successful. If there were validation errors, the response will include an error result. |
Please also see error result.
Please also see common HTTP status codes.
Response parameters
| Parameter | Description |
|---|---|
| selfServiceProductGUID | The GUID of the product |
| name | The name of the product |
| description | The description of the product |
| managedByGroupName | The name of the group that manages this product |
| category | The category name of the product |
| code | The code (SKU) of the product |
| selfServiceProductOptions | A list of Self Service Product Option objects |
| isEnabled | Indicates if the product is enabled |
| isAutoApprove | Indicates if the product is automatically approved |
| isAutoDeny | Indicates if the product is automatically denied |
| requestCommentOption | Indicates whether a comment is optional, required or not possible when requesting |
| returnOnUserDisable | Indicates whether the product will be returned when the user owning the product gets disabled |
| Icon | The hash of custom icon. |
| FaIcon | The name of a font-awesome icon. |
| UseFaIcon | A boolean value indicating if the specified font-awesome icon should be used. |
| MultipleRequestOption | A value indicating how often a product can be requested. Possible values: 1: Once 2: Always |
| ReminderTimeout | The timeout duration of the reminders in days, where 0 means never. |
| OwnershipMaxDuration | The duration that that can be requested for this product in days, where 0 means indefinitely. |
| HasTimeLimit | Can there be a maximum duration of product ownership |
| LimitType | What type is the duration limit. Options: Fixed / Maximum |
| ManagerCanOverrideDuration | Can the duration as requested by a user be overridden when approving. |
| Actions | A list of actions linked to the product. |
| HasRiskFactor | Indicates if the product has a risk factor. |
| RiskFactor | The risk factor of the product. This value can be null or a number between 1 and 10. |
| MaxCount | The maximum times a product can be requested. |
| ShowPrice | Show the price of the product to the end user. |
| Price | The price of a product. Can be a number with decimals, divided by a comma or point. |
Self Service Product Option object
| Parameter | Description |
|---|---|
| selfServiceProductOptionGUID | The GUID of the product option |
| name | The name of the product option |
| selfServiceProductOptionItems | A list of Self Service Product Option Item objects |
Self Service Product Option Item object
| Parameter | Description |
|---|---|
| key | The key of the product option item |
| value | The key of the product option item |
| code | The code (SKU) of the product option item |
Sample response body
{
"actions": [
{
"actionGUID": "34e79fc9-9fd6-439d-b106-088a552534a0",
"name": "Custom PowerShell script",
"options": 1,
"objectGUID": "aada90fd-88b3-4b1a-9350-a42e67c69a2d",
"executeOnState": 5,
"automationStoreTaskId": "4d20769f-80f1-48f6-acd1-33e642aa211d",
"automationStoreTaskVersion": "1.0.0",
"executionType": "native",
"executionEntry": "powershell-script",
"executionEnvironment": "helloid-agent",
"executionMinimumVersion": "1.1.0",
"variables": [
{
"id": "b8f866fc-564f-4db6-98fe-303508df1113",
"name": "powerShellScript",
"value": "Write-host \"Please enter your name:\"\n$userName = read-host\n\"Hello $userName!\"",
"typeConstraint": "string",
"secure": false,
"isScriptVariable": false
},
{
"id": "bf626780-9d9b-4558-af6b-a4333b8ad3b7",
"name": "powerShellScriptGuid",
"value": null,
"typeConstraint": "string",
"secure": false,
"isScriptVariable": false
},
{
"id": "434e66a9-b62f-44c1-a01b-7bdff33de90e",
"name": "useTemplate",
"value": "false",
"typeConstraint": "boolean",
"secure": false,
"isScriptVariable": false
}]
}],
"selfServiceProductGUID": "de0bec60-7b75-4c97-aecb-2bc30aac4324",
"name": "Test Product",
"description": null,
"managedByGroupName": "Administrators",
"category": "Applications",
"code": "20170612EUUPKVJPDD",
"isEnabled": false,
"isAutoApprove": false,
"isAutoDeny": false,
"requestCommentOption": "Optional",
"returnOnUserDisable": false,
"Icon": null,
"FaIcon" : "fa-rocket",
"UseFaIcon": true,
"MultipleRequestOption": 1,
"ReminderTimeout": 30,
"OwnershipDuration": 90,
"HasTimeLimit": true,
"ManagerCanOverrideDuration": true,
"LimitType": "Fixed",
"hasRiskFactor": false,
"riskFactor": 1,
"maxCount": null,
"showPrice": false,
"price": 50
}
Example request with cURL
Replace placeholder values surrounded by { } with the actual values.
curl -u {api-key}:{api-secret} -X GET https://{company-name}.helloid.com/api/v1/selfservice/products/{SelfServiceProductGuid}