Understanding ID Forgery Detection: A Comprehensive Guide

Introduction

In today's digital age, the security and authenticity of identity documents are paramount. With the increasing prevalence of identity fraud, it is crucial for businesses and institutions to have robust methods for verifying the authenticity of ID cards. The ID Forgery Detection API provided by ADVANCE offers a reliable solution for detecting forged ID cards. This guide will walk you through the key aspects of the ID Forgery Detection API, including its usage, common issues, and troubleshooting steps.

What is the ID Forgery Detection API?

The ID Forgery Detection API is a sophisticated tool designed to analyze images of ID cards and determine their authenticity. By leveraging advanced image processing and machine learning techniques, the API can identify various types of forgery, such as black and white photocopies, retakes or screenshots, modified NIK, pasted faces, colorful photocopies, poor quality images, and scanned documents.

How to Use the ID Forgery Detection API

To utilize the ID Forgery Detection API, follow these steps:

  1. Endpoint and Headers:

    • Endpoint: https://api.advance.ai/openapi/face-identity/v2/id-forgery-detection
    • Headers: Include your access token and set the content type to multipart/form-data.
  2. Parameters:

    • cardImage: The image file of the ID card you wish to verify.
    • cardType: The type of ID card (e.g., ktp for Indonesian ID cards).
  3. Sample Request:

    bash
     
    curl -X POST \ -H "X-ACCESS-TOKEN: {Your Access Token}" \ -H "Content-Type: multipart/form-data" \ -F "cardImage=@/path/to/ocrImage.jpg" \ -F "cardType=ktp" \ "https://api.advance.ai/openapi/face-identity/v2/id-forgery-detection"

Common Issues and Troubleshooting

  1. Sample Issue:

    • Problem: The API returns an error indicating that the ID card image could not be processed.
  2. Diagnosis of the Issue:

    • Image Quality: Ensure the uploaded image meets the required specifications:
      • Formats: PNG, JPG, JPEG
      • Maximum file size: 2 MB
      • Resolution: Between 256 x 256 and 4096 x 4096 pixels
      • Clean background with no words or other pictures
      • Correct orientation (vertical or horizontal, not heavily tilted)
    • Parameter Verification: Check that all required parameters are correctly included and formatted.
    • API Response Codes: Review the status codes returned by the API to identify specific issues (e.g., PARAMETER_ERROR, NO_SUPPORTED_CARD, TOO_MANY_CARDS).
  3. Solution of the Issue:

    • Improve Image Quality: Ensure the image adheres to the quality standards outlined above.
    • Correct API Parameters: Verify and correct the parameters in the API request.
    • Handle API Errors: Implement error handling based on the status codes returned by the API and follow the recommended actions:
      • PARAMETER_ERROR: Check for missing or invalid parameters and correct them.
      • NO_SUPPORTED_CARD: Ensure the image contains a supported ID card.
      • TOO_MANY_CARDS: Ensure only one ID card is present in the image.

Understanding ID Forgery Detection: A Comprehensive Guide

To access the ID Forgery Detection API, you need an Access Token. Follow these steps 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 encounter issues that persist despite following the above guidelines, please contact us at help@advance.ai or submit a ticket via advance.ai support for further assistance. Our support team is here to help you resolve any challenges and ensure the effective use of the ID Forgery Detection API.

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

Comments

0 comments

Please sign in to leave a comment.