Introduction
The Multi-Platform Detection Service by ADVANCE is a powerful tool designed to help businesses verify and detect fraudulent activities across multiple platforms. This service is crucial for ensuring the authenticity and validity of user information, such as phone numbers and ID numbers, which are essential for secure transactions and interactions. This guide provides an in-depth look at how to use the Multi-Platform Detection Service, common issues, and troubleshooting tips.
Overview of the Multi-Platform Detection Service
The Multi-Platform Detection Service allows businesses to verify phone numbers and ID numbers across different platforms. By using this service, businesses can detect invalid or fraudulent information, ensuring the security and integrity of their operations.
How to Use the Multi-Platform Detection Service
To effectively use the Multi-Platform Detection Service, follow these steps:
-
Endpoint and Headers:
- Endpoint:
https://api.advance.ai/openapi/multi-platform/v1/detect - Headers: Include your access token and set the content type to
application/json.
- Endpoint:
-
Parameters:
phoneNumber: The phone number to verify, starting with "+628" followed by 8-12 digits.idNumber: The 16-digit ID number to verify.includeSelf: Specify whether to include or exclude the self-check ("include" or "exclude").
-
Sample Request:
bashcurl -X POST \ -H "X-ACCESS-TOKEN: {Your Access Token}" \ -H "Content-Type: application/json" \ -d '{"phoneNumber":"+6281234567890","idNumber":"1234567890123456","includeSelf":"include"}' \ "https://api.advance.ai/openapi/multi-platform/v1/detect"
Common Issues and Troubleshooting
-
Sample Issue:
- Problem: Users often encounter "PARAMETER_ERROR" responses indicating that the phone number or ID number format is incorrect.
-
Diagnosis of the Issue:
- Error Messages: The "PARAMETER_ERROR" response includes messages such as:
- "Invalid phone number please check your phone number format or call segment."
- "Invalid ID number please check the ID format."
- "Parameter should not be empty."
- "IncludeSelf value should be include or exclude."
- Cause: These errors indicate issues with the input parameters, such as an incorrect phone number format (not starting with "+628" or incorrect length) or an incorrect ID number format (not a 16-digit number).
- Error Messages: The "PARAMETER_ERROR" response includes messages such as:
-
Solution of the Issue:
- Correct Parameter Formats: Ensure the input parameters are correctly formatted:
- Phone Number: Must start with "+628" and be followed by 8-12 digits (e.g., +6281234567890).
- ID Number: Must be a 16-digit number.
- IncludeSelf Parameter: Should be either "include" or "exclude".
- Validation: Double-check the parameters before making the API request to avoid errors.
- Correct Parameter Formats: Ensure the input parameters are correctly formatted:
Obtaining an Access Token
To use the Multi-Platform Detection Service, you need an Access Token. Here’s how to obtain one:
-
Endpoint:
https://api.advance.ai/openapi/auth/ticket/v1/generate-token -
Parameters:
accessKey: Your access keytimestamp: 13-digit-long timestampsignature: SHA256 encrypted combination ofaccessKey,secretKey, andtimestampperiodSecond(optional): Validity period (defaults to 3600 seconds)
-
Sample Request:
bashcurl -X POST \ -H "Content-Type: application/json" \ -d '{"accessKey":"yourAccessKey","signature":"yourSignature","timestamp":1648785145789,"periodSecond":3600}' \ "https://api.advance.ai/openapi/auth/ticket/v1/generate-token"
Further Assistance
If you continue to experience issues despite following the guidelines provided, please contact our support team for further assistance:
- Email: help@advance.ai
- Submit a Ticket: Via https://support.advance.ai/
Our support team is available to help resolve any issues and ensure you can effectively use the Multi-Platform Detection Service.
Comments
0 comments