OCR API

OCR API提供证件图片识别并返回相应的证件信息。

API 方式

Base URL

• 印尼节点：https://id.apitd.net/verification/kyc/ocr/v1
• 巴基斯坦节点：https://pk.apitd.net/verification/kyc/ocr/v1

API

认证参数

请求参数

响应参数

证件信息（card_info）

• 印尼KTP

  字段	字段类型	描述
  nik	String	ID card
  name	String	Name
  birthday	String	Date of birth
  birthplace	String	Place of birth
  gender	String	Gender
  blood_type	String	Blood group
  address	String	Address
  rt_rw	String	RT/RW
  village	String	Village
  street	String	Street (District)
  religion	String	Religion
  marital_status	String	Marital status
  occupation	String	Career
  nationality	String	Country of Citizenship
  expiry_date	String	Validity period
  issue_date	String	Issue date
  issue_location	String	Issue location
  province	String	Province of residence
  city	String	City

• 巴基斯坦身份证(正面/反面)

  字段	类型	描述	CNIC OR NIC
  card_side	String	The side of card: front
  id_number	String	ID card number	CNIC/NIC
  expiry_date	String	Expiry date of the card	CNIC
  issue_date	String	Issue date of the card	CNIC
  name	String	Name in English 备注：如果NIC证件该字段需要英语翻译，请联系商务/运营单独开通该增强型配置。	CNIC
  name_urdu	String	Name in Urdu	CNIC/NIC
  birthday	String	Date of birth	CNIC/NIC
  gender	String	Gender	CNIC/NIC
  father_name	String	Father's name in English 备注：如果NIC证件该字段需要英语翻译，请联系商务/运营单独开通该增强型配置。	CNIC/NIC
  father_name_urdu	String	Father's name in Urdu	CNIC/NIC
  identifier	String	Personal identifier	NIC
  country_of_stay	String	Country of stay	CNIC

  字段	类型	描述	CNIC OR NIC
  card_side	String	The side of card: back
  id_number	String	ID card number	CNIC/NIC
  current_address	String	Current address	CNIC/NIC
  expiry_date	String	Expiry date of the card	NIC
  family_number	String	Family number	NIC
  permanent_address	String	Permanent address	CNIC/NIC
  issue_date	String	Issue date of the card	NIC
  current_address_en	String	English translation of current address 备注：如果需要，请联系商务/运营单独开通该增强型配置。	CNIC/NIC
  permanent_address_en	String	English translation of current address 备注：如果需要，请联系商务/运营单独开通该增强型配置。	CNIC/NIC

证件伪造检测（document_forgery_info）

API 状态码

响应示例

• 入参示例：

{
  "image": "/9j/4AAQSkZJRgABAQAAeAB4AAD/********XLiqqauzsw1J3sf/2Q==",
  "country": "ID",
  "options": "document_forgery"
}

• 印尼业务请求成功：

{
    "result": "success",
    "code": 200,
    "sequence_id": "1721890950247464I31676CAC******",
    "message": "success",
    "card_info": {
        "birthday": "26-05-19**",
        "address": "KP.C****",
        "occupation": "WIRA****",
        "gender": "LAKI-LAKI",
        "city": "KABU****",
        "expiry_date": "SE****",
        "issue_location": "B****",
        "religion": "IS****",
        "nik": "327****60577****",
        "marital_status": "KAWIN",
        "birthplace": "BA****",
        "nationality": "WN****",
        "issue_date": "28-02-20**",
        "province": "JAWA****",
        "street": "MEGAMEND****",
        "blood_type": "-",
        "name": "M.TAUFAN****",
        "village": "CIPAY****",
        "rt_rw": "005/****"
    },
  "document_forgery_info":{
     "result":"fail",
     "detail":[
       "black_white_print"
     ]
  }
}

• 巴基斯坦业务请求成功：

{
   "result":"success",
   "code":200,
   "sequence_id":"1704275269816000X0A366B271******",
   "message":"success",
   "card_info":{
     "birthday":"10/12/19**",
     "identifier":"ش**تل",
     "id_number":"3****-21*****-1",
     "card_side":"front",
     "country_of_stay":"",
     "gender":"M",
     "issue_date":"",
     "father_name":"",
     "expiry_date":"",
     "name":"",
     "father_name_urdu":"و*****شق",
     "name_urdu":"نم*****د"
   }
}

• 业务不请求成功：

{
    "code": 11350,
    "sequence_id": "69b57131b6fb********61ccba118b60",
    "message": "Internal error"
}