Skip to main content
When you submit a phrase regeneration task, provide the callback URL using the calBackUrl field from the API schema. The system sends a POST request when the regenerated phrase is ready or the task fails.

Callback Mechanism Overview

The regenerated phrase callback uses the same response shape as validation phrase generation callbacks.

Callback Timing

  • New validation phrase generated and ready for the user to record
  • Phrase regeneration failed
  • Error occurred during task processing

Callback Method

  • HTTP Method: POST
  • Content Type: application/json
  • Timeout: 15 seconds

Callback Request Format

Field Description

integer
required
Callback status code. 200 indicates success; non-200 values indicate task failure or processing error.
string
required
Status message describing the callback result.
string
required
Task ID returned by the phrase regeneration API.
string
Regenerated validation phrase text. Returned when status is wait_validating.
string
required
Task status. Common callback statuses are wait_validating, processing_validate_fail, and fail.
integer
Error code returned when the task fails.
string
Detailed error message returned when the task fails.

Get Verification Phrase

Query the regenerated phrase manually with taskId