Request for check
    • PDF

    Request for check

    • PDF

    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-20241017/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
        },
        ...
      ]
    }
    
    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.