This section explains how to verify identity through email/SMS OTP. The following example assumes that the task owner requires signers to verify "before reading the task."

1. Request Read a Task API

The query string is as follows:

task_id=37126

2. Retrieve Verification Info from the Error Message

The API will respond with the following error message:

{
    "error_code": 403034,
    "error_message": "require verify before sign: stage_need_verify",
    "error_key": "stage_need_verify",
    "verify_info": [
        {
            "verify_type": "email",
            "verify_source": "[email protected]",
            "uuid": "138bdac7-1e81-4662-be08-de68a8346a95",
            "sequence": 1,
            "occassion": "read"
        }
    ],
    "verify_for": "identity_verify",
    "asked_by": "Task Owner",
    "triggered": true,
    "signer_email": "[email protected]"
}

3. Verify the OTP

To verify the OTP received from email or SMS, the query string is as follows:

task_id=37126&uuid=44cb0e62-9e48-44a3-82ad-3ee5fea2038c&verify_data=141999

In this case, the API will respond with a status code of 200 along with detailed information about the task. Additionally, there will be an identity_verify_token in the response which must be included in subsequent requests to the Sign a Task API.