Get Detection Results
- URL:
/GetResults/{uuid}
- Method:
GET
Request Parameters
Parameter | Type | Required | Description |
---|---|---|---|
uuid | string | Yes | UUID obtained from the detection task API endpoint |
Important Notes
- The
uuid
parameter must be obtained from the detection task interface.- The
status
value in a successful response can be either "wait" or "ok".- If the status is "wait", please retry the request every 3000-5000 milliseconds until the status changes to "ok".
- A status of "ok" indicates that all detection tasks for this uuid have been completed. At this point, the uuid will be automatically released and further requests for results will not be allowed.
- When deducting points, only cards with Live or Die results are counted. No points are deducted for Error or Format results.
- For each API call, the LiveList, DieList, ErrorList, and FormatErrorList only return the most recently completed detection results and do not include previously returned data.
Request Example
shcurl -X GET -k $API_URL/GetResults/$UUID
💡 Note: The uuid parameter is obtained from the check task interface.
Successful Response
Example of a successful response:
json{
"status": "wait",
"errorMsg": "",
"LiveList": ["52673609611211111|12|28|051"],
"DieList": ["52673601792232222|01|26|651"],
"ErrorList": [],
"FormatErrorList": [],
"n1": 3,
"n2": 2,
"uuid": "d4ddf512-7fe5-4992-ab7c-4bca0bcba401"
}
💡Important Notes:
- The
status
field in a successful response can be eitherwait
orok
. - If the status is
wait
, please retry the request every 3000-5000 milliseconds until the status changes to "ok". - A status of
ok
indicates that all detection tasks for this UUID have been completed. - Once the status is
ok
, the UUID will be automatically released and further requests for results will not be allowed. - Points are deducted only for cards with
Live
orDie
results. No points are deducted forError
orFormat
results. - The
LiveList
,DieList
,ErrorList
, and FormatErrorList contain only the most recently completed detection results and do not include previously returned data.
Error Response
Example of an error response:
json{
"status": "error",
"errorMsg": ""
}
Response Parameter Explanation
Attribute Name | Type | Description |
---|---|---|
status | string | wait, error, or ok |
LiveList | string[] | List of live cards |
DieList | string[] | List of dead cards |
ErrorList | string[] | List of error cards |
FormatErrorList | string[] | List of format error cards |
n1 | int | Total number of cards |
n2 | int | Number of cards checked so far |
errorMsg | string | Error message |