MENU
      Request for check

        Request for check


        Article summary

        Overview

        • Request for check of the checklist.
        • Each checklist has its own status (check request status), and only the check requests for the checklist whose status is NONE (status in which you can request a check) are performed.
          • status changes internally over the progress of the check request or over time, and has one of the following five values:
            • NONE: A check may be requested.
            • ENQUEUED: Waiting for a check.
            • PROCESSING: Check in progress.
            • DONE: Check request completed. Need to wait until the next request.
            • FAIL: Check failed.
        • The check request feature has a different re-request time for each related product.
          • When the checklist status is DONE, FAIL, and ENQUEUED, and the re-request time has elapsed, the status is initialized to NONE status.
        • Even if the check request is not performed due to the status of the checklist, it responds with a successful request processing (200, OK).
          • You can find out whether the check request was actually performed for each checklist through the requestSuccess field of the Response Body. (true: success / false: failure)
          • Even if the requestSuccess field responds as false, if the value of the status field is ENQUEUED, PROCESSING, it can be understood that the check request is already in progress.

        API

        • POST /categories/{categoryCode}/checkitems/refresh
          • Perform a check on all checklists corresponding to {categoryCode}.
        • POST /categories/{categoryCode}/checkitems/{itemCode}/refresh
          • Perform a check on all checklists corresponding to {itemCode}.
          • 404 error also occurs when a request is made by entering {itemCode} that is not included in the input {categoryCode}.

        Requests

        Headers

        You need a [common request header](/release-20250116/docs/en/management-cloud-advisor-overview#request header) specified in the overview.

        Path Variables

        Parameter nameRequirement statusTypeRestrictionsDescription
        categoryCodeNStringPlease see the Category offering and checklist.Category code
        itemCodeNStringPlease see the Category offering and checklist.Checklist code

        Responses

        • After performing the check, it responds with the same result as the search for checklist status feature.

        Response Body

        {
          "result": "SUCCESS",
          "contents": [
            {
              "itemCode": String,
              "timeToRefresh": Timestamp,
              "lastRequestTime": Timestamp,
              "status": String,
              "requestSuccess": Boolean
            },
            ...
          ]
        }
        JSON
        Response field nameRequirement statusTypeRestrictionsDescription
        itemCodeYStringChecklist code
        timeToRefreshYTimestampNext time available for check
        lastRequestTimeYTimestampLast check time
        statusYStringNONE, ENQUEUED, PROCESSING, DONE, FAILCurrent check request status
        NONE: A check may be requested.
        ENQUEUED: Waiting for a check
        PROCESSING: Check in progress
        DONE: Check request completed. Need to wait until the next request.
        FAIL: Request failed.
        requestSuccessYBooleantrue, falseWhether the check request for the checklist was successful

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.