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=12345

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=12345&uuid=44cb0e62-9e48-44a3-82ad-3ee5fea2038c&verify_data=123123

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.