Seamless Integration with Tele Status Query API

1. What is the Tele Status Query API? The Tele Status Query API retrieves the detection result of a phone number using the transactionId provided by the Tele Status Check API.

2. How does the Tele Status Query process work? Submit the transactionId to the API endpoint to receive the detection result.

3. What parameters are required?

• transactionId: The unique identifier from the Tele Status Check response.

4. How do I make an API request? Here’s an example using cURL:

curl -X POST \
-H "X-ACCESS-TOKEN: {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{"transactionId": "196eb0c777789e58"}' \
"https://api.advance.ai/openapi/verification/v2/tele-status-query"

5. What are the possible response codes?

• SUCCESS: The query was successful, and the phone status is provided.

• DETECTING: The phone status is still being determined.

• NO_RECORD: No matching record found for the transactionId.

• PARAMETER_ERROR: Ensure the transactionId is correct.

6. What information is returned in the response?

• status: Current phone status (e.g., REACHABLE, UNREACHABLE).

• message: Description of the phone status.

• transactionId: The unique identifier.

7. How do I interpret the phone status? Refer to the Phone Status codes provided by the Tele Status Check API for details on the status values (e.g., REACHABLE, UNREACHABLE).

8. How do I handle errors effectively?

• NO_RECORD: Double-check the transactionId.

• DETECTING: Wait and retry later.

• PARAMETER_ERROR: Verify the parameter’s format.

9. Are there any prerequisites for using the API? Ensure you have a valid access token obtained via the Token Authentication API and a stable network connection (use a VPN if in China).

10. What’s the advantage of using both APIs together? The Tele Status Check and Tele Status Query APIs offer a comprehensive solution for asynchronous and active status tracking, ensuring accuracy and reliability in phone number status detection.