Comprehensive Guide to Multi-Platform Detection Service

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:

  1. 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.
  2. 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").
  3. Sample Request:

    bash
     
    curl -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

  1. Sample Issue:

    • Problem: Users often encounter "PARAMETER_ERROR" responses indicating that the phone number or ID number format is incorrect.
  2. 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).
  3. 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.

Obtaining an Access Token

To use the Multi-Platform Detection Service, you need an Access Token. Here’s how to obtain one:

  1. Endpoint: https://api.advance.ai/openapi/auth/ticket/v1/generate-token

  2. Parameters:

    • accessKey: Your access key
    • timestamp: 13-digit-long timestamp
    • signature: SHA256 encrypted combination of accessKey, secretKey, and timestamp
    • periodSecond (optional): Validity period (defaults to 3600 seconds)
  3. Sample Request:

    bash
     
    curl -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:

Our support team is available to help resolve any issues and ensure you can effectively use the Multi-Platform Detection Service.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.