Get Service Order Status


Overview

Check progress status of Host-based Security Service Order.


API Operation Object

  • Host-based Security service order

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • GET

HTTP Request Path

{endpoint}/API/ScreenEventHBSOrderProgressRate?tenant_id={tenant_id}&locale={locale}&soid={soid}

HTTP Request Header

X-Auth-Token: <token_id>

Request Parameter

Request Parameters
item Required type format description
tenant_id yes String UUID Tenant ID of the owner (UUID)
soId yes String - This value is returned value of when you execute API of Order Host-based Security, Change menu or quantity, or Cancel the order
locale no String - Messages are displayed in Japanese or English depending on this value. ja: Japanese, en: English. Default value is "en".

Sample Request Body

This request does not include a request body.


Response

HTTP Response Code

Response Codes
Response Code Description
200 OK
400 Request format is invalid
401 Unauthorized
500 Internal Server Error
511 Internal Server Error (Fail Service Order etc.)

Response Parameter

Response Parameters
item type format description
code String - This code is for determining the details of the error.DEP-**: Successful Completion DEP-E**: Error has occurred
message String - This message is shown when error has occurred.
progressRate String - Percentage of Service Order Progress Status
status integer - This value indicates normal or abnormal. 1:normal, 2:abnormal

Sample Response Body

Normal Response

When locale is "ja"

{
    "code": "DEP-01",
    "message": "正常終了",
    "progressRate": "20",
    "status": 1
}

When locale is "en"
{
    "code": "DEP-01",
    "message": "Successful completion",
    "progressRate": "20",
    "status": 1
}

Error Response

When locale is "ja"

{
    "code": "DEP-E",
    "message": "システムエラーが発生しました。恐れ入りますが、チケットシステムでご連絡ください。",
    "status": 2,
}

When locale is "en"
{
    "code": "DEP-E",
    "message": "System error has occurred. Excuse me, please contact us at the ticket system.",
    "status": 2,
}