Unlocking the Power of Tele Status Check API

1. What is the Tele Status Check API? The Tele Status Check API allows you to check the status of a phone number. It’s an asynchronous API that provides status updates through a callback URL or via an active query interface using a transaction ID.

2. How does the Tele Status Check process work? The process involves four main steps:

1. Submit the phone number and your callback URL (postUrl).

2. Receive a response with the status code "SUCCESS," confirming the submission was successful.

3. Obtain updates on the phone status through your callback URL or query using the transactionId.

4. Charges apply only for successfully returned phone statuses.

3. What parameters are required to use the API?

• phone: The phone number in standard format (e.g., 081234567890).

• postUrl: Your callback URL (POST method required).

• phoneOwner (optional): An integer (0 for applicant, 1 for emergency contact).

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 '{"phone": "081234567890", "postUrl": "{your callback url}", "phoneOwner":1}' \
"https://api.advance.ai/openapi/verification/v2/tele-status-check"

5. How do I handle callback results? The callback request body includes the following parameters:

• code: Status code of the operation.

• message: Explanation of the status code.

• data: Includes phone, status (see Phone Status details), and transactionId.

A callback is considered successful when your system returns an HTTP status code of 200.

6. What phone statuses are provided?

• 1: REACHABLE — The phone number can be dialed.

• 2: UNREACHABLE — Temporarily unable to connect.

• 3: DISCONNECT — The number is out of service.

• 4: INVALID NUMBER — The number doesn’t exist.

7. Can I query the phone status actively? Yes, use the transactionId from the Tele Status Check API to query the detection result via the Tele Status Query API.

8. What are the common error responses and how to resolve them?

• INVALID_PHONE_NUMBER: Ensure the phone number format is correct.

• INVALID_URL: Verify the format of your callback URL.

• PARAMETER_ERROR: Check all required parameters.

9. Is VPN required for accessing the API? Yes, if your environment is in China, use a VPN to avoid packet loss or service timeouts.