Global ID Recognition API - ARGOS Identity

POST

recognition

Recognize and verify ID document

curl --request POST \
  --url https://idverify-api.argosidentity.com/modules/recognition \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "idImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "issuingCountry": "USA",
  "idType": "government_id",
  "idBackImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "callbackUrl": "https://your-domain.com/callback"
}
'

import requests

url = "https://idverify-api.argosidentity.com/modules/recognition"

payload = {
    "idImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "issuingCountry": "USA",
    "idType": "government_id",
    "idBackImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "callbackUrl": "https://your-domain.com/callback"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    idImage: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    issuingCountry: 'USA',
    idType: 'government_id',
    idBackImage: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    callbackUrl: 'https://your-domain.com/callback'
  })
};

fetch('https://idverify-api.argosidentity.com/modules/recognition', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://idverify-api.argosidentity.com/modules/recognition",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'idImage' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    'issuingCountry' => 'USA',
    'idType' => 'government_id',
    'idBackImage' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    'callbackUrl' => 'https://your-domain.com/callback'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://idverify-api.argosidentity.com/modules/recognition"

	payload := strings.NewReader("{\n  \"idImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"issuingCountry\": \"USA\",\n  \"idType\": \"government_id\",\n  \"idBackImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://idverify-api.argosidentity.com/modules/recognition")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"idImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"issuingCountry\": \"USA\",\n  \"idType\": \"government_id\",\n  \"idBackImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://idverify-api.argosidentity.com/modules/recognition")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"idImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"issuingCountry\": \"USA\",\n  \"idType\": \"government_id\",\n  \"idBackImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}"

response = http.request(request)
puts response.read_body

{
  "apiType": "id_recognition",
  "transactionId": "e0nvom3caiis7",
  "result": {
    "data": {
      "raw": {
        "address": {
          "value": "ADDRESS 110, SOMEWHERE STREET",
          "score": 89,
          "coordinates": {
            "first": {
              "x": 95,
              "y": 221
            },
            "fourth": {
              "x": 95,
              "y": 258
            },
            "second": {
              "x": 430,
              "y": 221
            },
            "third": {
              "x": 430,
              "y": 258
            }
          },
          "original_coordinates": {
            "first": {
              "x": 211,
              "y": 714
            },
            "fourth": {
              "x": 213,
              "y": 752
            },
            "second": {
              "x": 553,
              "y": 713
            },
            "third": {
              "x": 554,
              "y": 751
            }
          }
        },
        "authority": {
          "value": "{{value}}",
          "score": 4,
          "coordinates": {
            "first": {
              "x": 796,
              "y": 1460
            },
            "fourth": {
              "x": 799,
              "y": 1637
            },
            "second": {
              "x": 1931,
              "y": 1461
            },
            "third": {
              "x": 1925,
              "y": 1641
            }
          }
        },
        "name": {
          "value": "{{value}}",
          "score": 61,
          "coordinates": {
            "first": {
              "x": 367,
              "y": 462
            },
            "fourth": {
              "x": 375,
              "y": 669
            },
            "second": {
              "x": 1379,
              "y": 454
            },
            "third": {
              "x": 1378,
              "y": 663
            }
          }
        },
        "name_chn": {
          "value": "{{value}}",
          "score": 61,
          "coordinates": {
            "first": {
              "x": 367,
              "y": 462
            },
            "fourth": {
              "x": 375,
              "y": 669
            },
            "second": {
              "x": 1379,
              "y": 454
            },
            "third": {
              "x": 1378,
              "y": 663
            }
          }
        },
        "number": {
          "value": "{{value}}",
          "score": 95,
          "accepted": true,
          "coordinates": {
            "first": {
              "x": 248,
              "y": 698
            },
            "fourth": {
              "x": 256,
              "y": 867
            },
            "second": {
              "x": 1423,
              "y": 691
            },
            "third": {
              "x": 1421,
              "y": 861
            }
          }
        },
        "rotate": {
          "value": "0"
        }
      },
      "ocr": {
        "ocr_fullName": "{{ocr_fullName}}",
        "ocr_firstName": "{{ocr_firstName}}",
        "ocr_middleName": "{{ocr_middleName}}",
        "ocr_lastName": "{{ocr_lastName}}",
        "ocr_gender": "{{ocr_gender}}",
        "ocr_nationality": "{{ocr_nationality}}",
        "ocr_birthDate": "{{ocr_birthDate}}",
        "ocr_identityNumber": "{{ocr_identityNumber}}",
        "ocr_issueDate": "{{ocr_issueDate}}",
        "ocr_expireDate": "{{ocr_expireDate}}",
        "ocr_version": "{{ocr_version}}",
        "ocr_number": "{{ocr_number}}",
        "full_mrz": "{{full_mrz}}",
        "mrz_line1": "{{mrz_line1}}",
        "mrz_line2": "{{mrz_line2}}"
      }
    },
    "review_front": true,
    "review_back": false,
    "document_type": "{{document_type}}"
  }
}

Global ID Recognition API는 ID의 앞면과 뒷면 이미지, 발급 국가 및 ID 유형을 분석하여 신분증을 처리하고 검증합니다. 이 API는 상세한 OCR(광학 문자 인식)을 통해 제공된 ID의 진위성과 유효성을 보장하며 포괄적인 결과를 제공합니다.

API 개요

Global ID Recognition API는 전 세계 ID 문서 처리를 위한 강력한 도구로 다음과 같은 기능을 제공합니다:

전 세계 지원: 여러 국가의 ID 문서 처리
자동 인식: ID 유형과 발급 국가를 자동으로 감지
OCR 기술: 텍스트 추출을 위한 고급 광학 문자 인식
데이터 추출: ID 문서에서 구조화된 데이터 추출
검증: 문서의 진위성과 유효성 검증
다중 형식 지원: 다양한 ID 문서 형식 처리

요청 매개변수

필수 매개변수

idImage: base64 형식의 ID 문서 앞면 이미지
issuingCountry: ID 문서 발급 국가의 ISO 3 Alpha 국가 코드
idType: ID 문서의 유형

선택적 매개변수

idBackImage: base64 형식의 ID 문서 뒷면 이미지
callbackUrl: 인식 결과가 완료 시 전송될 URL

인증

x-api-key: 인증 및 접근 제어를 위한 필수 API 키

응답 형식

result 의 내용은 두 처리 모드에서 동일합니다. 이를 감싸는 바깥 구조만 다릅니다.

apiType: 고정값 id_recognition
transactionId: 각 요청의 고유 식별자
result: 인식 결과
- document_type: 인식된 신분증 유형. 엔진이 판별하지 못하면 <issuingCountry>.<idType> 조합으로 대체됩니다(예: KOR.drvlic)
- review_front: 앞면 인식 결과 유무
- review_back: 뒷면 인식 결과 유무. idBackImage 를 보낸 경우에만 존재합니다
- data.raw: 필드별 엔진 원본 출력. 각 필드는 다음을 포함할 수 있습니다
  - value: 인식 값. 엔진 반환 값을 그대로 전달합니다 (string · number · boolean)
  - score: 신뢰도 점수 0~100. 엔진이 해당 필드의 점수를 반환한 경우에만 존재합니다
  - accepted: 유효성 판정. 엔진이 해당 필드의 판정을 반환한 경우에만 존재합니다
  - coordinates: 크롭된 이미지 기준 Bounding Box. first · second · third · fourth 꼭지점으로 구성됩니다
  - original_coordinates: 크롭 이전 원본 업로드 이미지 기준 Bounding Box
- data.ocr: 보정을 거친 최종 OCR 값. 각 ocr_* 키에는 accepted_ocr_* 가 함께 올 수 있습니다

어떤 키가 오는지는 신분증 종류·발급 국가·엔진 인식 결과에 따라 달라집니다. 모든 필드를 선택적으로 다루시고, 값을 신뢰하기 전에 accepted_ocr_* 를 확인하세요.

지원되는 국가 및 ID 유형

주요 국가들

USA: 미국
CAN: 캐나다
MEX: 멕시코
BRA: 브라질
ARG: 아르헨티나
GBR: 영국
DEU: 독일
FRA: 프랑스
ESP: 스페인
ITA: 이탈리아
KOR: 대한민국
JPN: 일본
CHN: 중국
AUS: 호주
NZL: 뉴질랜드

각 국가별로 지원되는 모든 신분증 유형 목록은 용어집/지원되는 신분증 유형에서 확인하세요.

ID 유형

government_id: 정부에서 발급한 공식 신분증으로, 개인의 신원을 확인하는 데 사용됩니다
passport: 정부에서 발급한 공식 여행 문서로, 소지자의 신원과 국적을 인증하며 주로 국제 여행에 사용됩니다
drivers_license: 특정 개인이 오토바이, 자동차, 트럭 또는 버스와 같은 모터화된 차량을 운전할 수 있도록 허가하는 공식 문서입니다
residence_permit: 외국인이 특정 기간 동안 국가에 거주할 수 있도록 허용하는 공식 문서로, 주로 이민 당국에서 발급합니다
vehicle_registration_certificate: 차량 등록 증명을 제공하는 공식 문서로, 차량 및 소유자에 대한 세부 정보를 포함합니다
visa: 여권에 배치된 공식 승인으로, 소지자가 특정 기간 동안 국가에 입국, 출국 또는 체류할 수 있음을 나타냅니다
aadhaar: 인도 정부가 인도 거주자에게 발급한 고유한 12자리 식별 번호로, 생체 인식 및 인구 통계 데이터를 기반으로 합니다
pancard: 인도 정부가 개인 및 법인에게 발급한 영구 계정 번호(PAN) 카드로, 주로 세금 목적으로 사용됩니다

각 국가별로 지원되는 모든 신분증 유형 목록은 용어집/지원되는 신분증 유형에서 확인하세요.

사용 사례

KYC 프로세스: 고객 신원 확인 간소화
은행: 계좌 개설을 위한 고객 신원 확인
여행: 여행 문서 및 비자 처리
고용: 직원 신원 및 작업 허가증 확인
정부 서비스: 공식 신분증 처리

처리 모드

callbackUrl 은 선택입니다. 보내는지 여부에 따라 결과를 받는 방식이 달라집니다.

동기 — callbackUrl 미제공

처리가 끝날 때까지 연결을 유지하다가 HTTP 200 본문으로 결과를 반환합니다.

{
  "apiType": "id_recognition",
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "result": { "document_type": "kor.rp.type1", "review_front": true, "data": { "raw": {}, "ocr": {} } }
}

동기 응답 본문에는 statusCode 와 webhookUrl 이 포함되지 않습니다.

비동기 — callbackUrl 제공

즉시 돌아오는 HTTP 200 은 접수 확인일 뿐입니다.

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "request has been successfully received. The response will be sent to https://your-domain.com/webhook"
}

결과는 이후 callbackUrl 로 발송됩니다. 그 본문은 동기 응답과 같은 result 에 두 필드가 더 붙습니다.

{
  "apiType": "id_recognition",
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "result": { "...": "동기 응답의 result 와 동일" },
  "statusCode": 200,
  "webhookUrl": "https://your-domain.com/webhook"
}

처리 중 실패해도 웹훅은 도착합니다. 이때 statusCode 가 400 이고 result 대신 message / errorCode 가 옵니다. 즉시 응답은 이미 200 으로 나간 뒤이므로, 최종 성패는 웹훅의 statusCode 로 판정해야 합니다.

유효성 검증 실패(idImage · issuingCountry · idType 누락, 이미지 포맷 오류, 지원하지 않는 국가·신분증 유형)는 두 모드 모두 즉시 HTTP 400 으로 반환됩니다.

이미지 요구사항

파일 크기

권장: 10MB 미만
최대: 50MB

이미지 품질

해상도: 최소 300 DPI 권장
형식: 고대비, 밝게 조명된 이미지가 가장 좋습니다
방향: 문서가 올바르게 방향을 맞춰야 합니다

지원되는 형식

JPEG (.jpg, .jpeg)
PNG (.png)

오류 처리

400 상태 코드는 필수 매개변수 누락 등으로 인해 요청이 허용되지 않음을 나타냅니다. callbackUrl이 제공되는 비동기 작업에서는 요청 검증 중에 오류가 감지됩니다.

errorCode 유형

다음 표는 API에서 반환되는 구체적인 errorCode를 보여줍니다:

상태 코드	errorCode	설명	발생 유형
400	1001	Workspace is unavailable	워크스페이스를 현재 사용할 수 없음
400	1003	Fail to process data	서버상의 이슈로 인해 데이터 처리 실패 및 재시도 권장
400	1005	idImage is required	idImage가 필요함
400	1006	issuingCountry is required	issuingCountry가 필요함
400	1009	Fail to analyze data	신분증 이미지 분석 실패 및 재시도 권장
400	1011	Fail to recognize idCard	ID 카드 인식 실패: 통상적으로 유저가 제출한 신분증이 앞서 지정한 신분증(idType, issuingCountry)과 다른 경우 발생
400	1012	Fail to recognize back of an idCard	ID 카드 뒷면 인식 실패: 통상적으로 유저가 제출한 신분증이 앞서 지정한 신분증(idType, issuingCountry)과 다른 경우 발생
400	1013	Invalid image format	잘못된 이미지 형식 (base64 가 아닐 때)
400	1014	idType is required	idType이 필요함
400	1015	invalid inputs : missing fields	잘못된 입력: 누락된 필드가 존재

이 엔드포인트에서 callbackUrl 은 선택입니다. 생략하면 동기 처리로 동작하며, 필수 파라미터 누락이 아닙니다.

인증

x-api-key

string

header

필수

본문

application/json

idImage

string

필수

Image of the front side of the ID document in base64 format. Base64 encoded characters in the payload must not include the MIME type. For example, if the encoded base64 characters are "image/png;base64,/9j/2wBDABQODxIP...", then remove "image/png;base64," and send only the encoded data "/9j/2wBDABQODxIP...".

예시:

"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="

issuingCountry

string

필수

The ISO 3 Alpha Country Code of the issuing country for the ID document.

예시:

"USA"

idType

enum<string>

필수

The type of the ID document

사용 가능한 옵션:

government_id,

passport,

drivers_license,

residence_permit,

vehicle_registration_certificate,

visa,

aadhaar,

pancard

예시:

"government_id"

idBackImage

string

Image of the back side of the ID document in base64 format.

예시:

"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="

callbackUrl

string<uri>

The URL where the recognition results will be sent upon completion. If a callbackUrl is provided, the process works asynchronously. If no callbackUrl is provided, the process operates synchronously.

예시:

"https://your-domain.com/callback"

응답

Successful ID recognition

Synchronous result (no callbackUrl)
Asynchronous acknowledgement (callbackUrl provided)

apiType

string

API type identifier

예시:

"id_recognition"

transactionId

string

Unique identifier for each request

예시:

"txn_123456789"

result

object

Object containing the processing result

Show child attributes

⌘I

Recognize and verify ID document

curl --request POST \
  --url https://idverify-api.argosidentity.com/modules/recognition \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "idImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "issuingCountry": "USA",
  "idType": "government_id",
  "idBackImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
  "callbackUrl": "https://your-domain.com/callback"
}
'

import requests

url = "https://idverify-api.argosidentity.com/modules/recognition"

payload = {
    "idImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "issuingCountry": "USA",
    "idType": "government_id",
    "idBackImage": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
    "callbackUrl": "https://your-domain.com/callback"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    idImage: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    issuingCountry: 'USA',
    idType: 'government_id',
    idBackImage: 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    callbackUrl: 'https://your-domain.com/callback'
  })
};

fetch('https://idverify-api.argosidentity.com/modules/recognition', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://idverify-api.argosidentity.com/modules/recognition",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'idImage' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    'issuingCountry' => 'USA',
    'idType' => 'government_id',
    'idBackImage' => 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
    'callbackUrl' => 'https://your-domain.com/callback'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://idverify-api.argosidentity.com/modules/recognition"

	payload := strings.NewReader("{\n  \"idImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"issuingCountry\": \"USA\",\n  \"idType\": \"government_id\",\n  \"idBackImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://idverify-api.argosidentity.com/modules/recognition")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"idImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"issuingCountry\": \"USA\",\n  \"idType\": \"government_id\",\n  \"idBackImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://idverify-api.argosidentity.com/modules/recognition")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"idImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"issuingCountry\": \"USA\",\n  \"idType\": \"government_id\",\n  \"idBackImage\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==\",\n  \"callbackUrl\": \"https://your-domain.com/callback\"\n}"

response = http.request(request)
puts response.read_body

{
  "apiType": "id_recognition",
  "transactionId": "e0nvom3caiis7",
  "result": {
    "data": {
      "raw": {
        "address": {
          "value": "ADDRESS 110, SOMEWHERE STREET",
          "score": 89,
          "coordinates": {
            "first": {
              "x": 95,
              "y": 221
            },
            "fourth": {
              "x": 95,
              "y": 258
            },
            "second": {
              "x": 430,
              "y": 221
            },
            "third": {
              "x": 430,
              "y": 258
            }
          },
          "original_coordinates": {
            "first": {
              "x": 211,
              "y": 714
            },
            "fourth": {
              "x": 213,
              "y": 752
            },
            "second": {
              "x": 553,
              "y": 713
            },
            "third": {
              "x": 554,
              "y": 751
            }
          }
        },
        "authority": {
          "value": "{{value}}",
          "score": 4,
          "coordinates": {
            "first": {
              "x": 796,
              "y": 1460
            },
            "fourth": {
              "x": 799,
              "y": 1637
            },
            "second": {
              "x": 1931,
              "y": 1461
            },
            "third": {
              "x": 1925,
              "y": 1641
            }
          }
        },
        "name": {
          "value": "{{value}}",
          "score": 61,
          "coordinates": {
            "first": {
              "x": 367,
              "y": 462
            },
            "fourth": {
              "x": 375,
              "y": 669
            },
            "second": {
              "x": 1379,
              "y": 454
            },
            "third": {
              "x": 1378,
              "y": 663
            }
          }
        },
        "name_chn": {
          "value": "{{value}}",
          "score": 61,
          "coordinates": {
            "first": {
              "x": 367,
              "y": 462
            },
            "fourth": {
              "x": 375,
              "y": 669
            },
            "second": {
              "x": 1379,
              "y": 454
            },
            "third": {
              "x": 1378,
              "y": 663
            }
          }
        },
        "number": {
          "value": "{{value}}",
          "score": 95,
          "accepted": true,
          "coordinates": {
            "first": {
              "x": 248,
              "y": 698
            },
            "fourth": {
              "x": 256,
              "y": 867
            },
            "second": {
              "x": 1423,
              "y": 691
            },
            "third": {
              "x": 1421,
              "y": 861
            }
          }
        },
        "rotate": {
          "value": "0"
        }
      },
      "ocr": {
        "ocr_fullName": "{{ocr_fullName}}",
        "ocr_firstName": "{{ocr_firstName}}",
        "ocr_middleName": "{{ocr_middleName}}",
        "ocr_lastName": "{{ocr_lastName}}",
        "ocr_gender": "{{ocr_gender}}",
        "ocr_nationality": "{{ocr_nationality}}",
        "ocr_birthDate": "{{ocr_birthDate}}",
        "ocr_identityNumber": "{{ocr_identityNumber}}",
        "ocr_issueDate": "{{ocr_issueDate}}",
        "ocr_expireDate": "{{ocr_expireDate}}",
        "ocr_version": "{{ocr_version}}",
        "ocr_number": "{{ocr_number}}",
        "full_mrz": "{{full_mrz}}",
        "mrz_line1": "{{mrz_line1}}",
        "mrz_line2": "{{mrz_line2}}"
      }
    },
    "review_front": true,
    "review_back": false,
    "document_type": "{{document_type}}"
  }
}

​API 개요

​요청 매개변수

​필수 매개변수

​선택적 매개변수

​인증

​응답 형식

​지원되는 국가 및 ID 유형

​주요 국가들

​ID 유형

​사용 사례

​처리 모드

​동기 — callbackUrl 미제공

​비동기 — callbackUrl 제공

​이미지 요구사항

​파일 크기

​이미지 품질

​지원되는 형식

​오류 처리

​errorCode 유형

인증

본문

응답

API 개요

요청 매개변수

필수 매개변수

선택적 매개변수

인증

응답 형식

지원되는 국가 및 ID 유형

주요 국가들

ID 유형

사용 사례

처리 모드

동기 — callbackUrl 미제공

비동기 — callbackUrl 제공

이미지 요구사항

파일 크기

이미지 품질

지원되는 형식

오류 처리

errorCode 유형