Server-side API integration (OCR supported)

API

• API name: Id2MetaVerifyWithOCR

• Description: Extracts the name and ID number from images of a second-generation Chinese national ID card (both the portrait side and the national emblem side) and verifies the information against an authoritative source.

• QPS limit: This API is subject to a dedicated QPS limit. For more information, see QPS Limit Description for Information Verification APIs.

• Endpoint:

  Region	IPv4	IPv6
  common	cloudauth.aliyuncs.com	cloudauth-dualstack.aliyuncs.com
  China (Beijing)	cloudauth.cn-beijing.aliyuncs.com	cloudauth-dualstack.cn-beijing.aliyuncs.com
  China (Shanghai)	cloudauth.cn-shanghai.aliyuncs.com	cloudauth-dualstack.cn-shanghai.aliyuncs.com

  Note

  • To reduce latency, select an endpoint that is geographically close to your servers.

  • You can also create a list of endpoints and poll them in rotation to improve availability.

  Important

  The Information Verification Service does not support a hard cap on call volume or automatic deactivation. To control costs and prevent high bills, configure spending alert rules after you integrate the service:

  1. Configure spending alerts: Set a spending alert rule (Set high-spending alerts) to monitor your bills in real time.

  2. Monitor data transfer plan balance: If you purchased a data transfer plan, also monitor its balance (Configure remaining quota alerts) to add resources or adjust your call policy promptly.

Image requirements

• Image size: The image file cannot exceed 2 MB. Large images may increase API response times or cause a timeout error.

• Image format: PNG, JPG, or JPEG.

• Image resolution: Both the width and height must be greater than 64 pixels and less than 8192 pixels.

• Image quality: Blurry images, obscured content, poor lighting, or skewed angles can negatively affect recognition. When recognizing the portrait side of an ID card, ensure the face is oriented forward.

Request parameters

Response parameters

{
  "address": "********, Example Street, Example City",
  "birthDate": "19901226",
  "certName": "John S***",
  "certNo": "1234561990122*****",
  "nationality": "Han",
  "authority": "xxx Public Security Bureau",
  "startDate": "20201130",
  "endDate": "20301130"
}