Textify AutoParser API

POST

textify

parser

curl --request POST \
  --url https://textify-api.argosidentity.com/v1/textify/parser \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "country": "mex",
  "image": "base64-encoded-image-data"
}
'

{
  "rawExtractions": {
    "nombre": "LUIS DANIEL",
    "domicilio": "C CAMPO AEREO 24",
    "clave_de_elector": "SLGZL501094H42BH00",
    "fecha_de_nacimiento": "09/09/2001"
  },
  "standardized": {
    "country": "MEX",
    "person": {
      "name": {
        "givenName": "LUIS DANIEL",
        "paternalSurname": "GUZMAN",
        "fullName": "LUIS DANIEL GUZMAN"
      },
      "gender": "male",
      "dateOfBirth": "2001-09-09",
      "nationality": "MEX"
    },
    "document": {
      "type": "voter_id",
      "number": "SLGZL501094H42BH00",
      "issueDate": "2019-01-01",
      "expiryDate": "2030-12-31",
      "issuingAuthority": "INSTITUTO NACIONAL ELECTORAL"
    },
    "address": {
      "street": "C CAMPO AEREO 24",
      "city": "HUAJUAPAN DE LEON",
      "state": "OAX",
      "postalCode": "69007"
    }
  }
}

{
  "message": "Request body must contain an image field with base64 data."
}

{
  "message": "Access Denied: API Key is unavailable."
}

{
  "message": "Image file too large"
}

{
  "message": "Unsupported file format. Only JPEG and PNG files are supported."
}

{
  "message": "Rate limit exceeded"
}

{
  "message": "OpenAI/Gemma API Server Error"
}

Textify ID AutoParser API는 정부 발급 신분증을 처리해 이미지에서 구조화 데이터를 추출하는 문서 텍스트 추출 서비스입니다. 네 가지 템플릿으로 신분증을 지원합니다. 첫째는 일반 템플릿으로, 두 번째 유형에 속하지 않는 국가의 모든 신분증에 적용됩니다. 두 번째 유형은 멕시코(MEX), 필리핀(PHL), 대한민국(KOR) 신분증입니다.

지원 이미지 형식

✅ 지원:

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

❌ 미지원:

GIF (.gif)
BMP (.bmp)
WebP (.webp)
TIFF (.tiff, .tif)
PDF (.pdf)

응답 시간

⏱️ 예상 응답 시간: 20-30초 API는 고급 OCR과 데이터 추출 알고리즘으로 이미지를 처리하므로 처리 시간이 꽤 걸립니다. 클라이언트 애플리케이션의 타임아웃은 최소 60초로 잡으세요.

이미지 요구 사항

파일 크기

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

이미지 품질

해상도: 최소 300 DPI 권장
형식: 대비가 높고 조명이 밝은 이미지가 가장 좋습니다
방향: 신분증이 회전되지 않고 바른 방향이어야 합니다

Base64 인코딩

이미지는 전송 전에 Base64 형식으로 변환해야 합니다. Base64 문자열에는 data URI 접두어 없이 인코딩된 이미지 데이터만 넣어야 합니다(예: data:image/jpeg;base64,가 있으면 제거).

오류 처리

주요 오류 상황

Status Code	Error Type	설명
400	Bad Request	요청 본문에 base64 데이터가 담긴 image 필드가 있어야 합니다.
401	Unauthorized	접근 거부: API 키를 사용할 수 없습니다.
413	Payload Too Large	이미지 파일이 너무 큽니다
415	Unsupported Media Type	지원하지 않는 파일 형식입니다. JPEG와 PNG 파일만 지원합니다.
429	Too Many Requests	요청 한도를 초과했습니다
500	Internal Server Error	OpenAI/Gemma API 서버 오류

소개

Textify👋에 오신 것을 환영합니다 - 스마트 문서 처리 솔루션

Textify API

파일 확장자와 문서 유형에 따라 파일을 분석해 유용한 인사이트와 정보를 추출합니다.

인증

x-api-key

string

header

필수

본문

application/json

image

string

필수

Base64 encoded image data. Only JPEG (.jpg, .jpeg) and PNG (.png) are supported. Encode the bytes of the image file and send only the encoded string, without a data URI prefix such as data:image/png;base64,.

country

enum<string>

Country code: "mex" (Mexico) or "phl" (Philippines) or "kor" (South Korea). Optional field that provides more concrete results when used.

사용 가능한 옵션:

mex,

phl,

kor

응답

Successful parsing

rawExtractions

object

Raw OCR results based on the fields depicted on the ID document. Output varies by document type and country.

standardized

object

Standardized data structure. Output format depends on country template used.

Show child attributes

⌘I

curl --request POST \
  --url https://textify-api.argosidentity.com/v1/textify/parser \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "country": "mex",
  "image": "base64-encoded-image-data"
}
'

{
  "rawExtractions": {
    "nombre": "LUIS DANIEL",
    "domicilio": "C CAMPO AEREO 24",
    "clave_de_elector": "SLGZL501094H42BH00",
    "fecha_de_nacimiento": "09/09/2001"
  },
  "standardized": {
    "country": "MEX",
    "person": {
      "name": {
        "givenName": "LUIS DANIEL",
        "paternalSurname": "GUZMAN",
        "fullName": "LUIS DANIEL GUZMAN"
      },
      "gender": "male",
      "dateOfBirth": "2001-09-09",
      "nationality": "MEX"
    },
    "document": {
      "type": "voter_id",
      "number": "SLGZL501094H42BH00",
      "issueDate": "2019-01-01",
      "expiryDate": "2030-12-31",
      "issuingAuthority": "INSTITUTO NACIONAL ELECTORAL"
    },
    "address": {
      "street": "C CAMPO AEREO 24",
      "city": "HUAJUAPAN DE LEON",
      "state": "OAX",
      "postalCode": "69007"
    }
  }
}

{
  "message": "Request body must contain an image field with base64 data."
}

{
  "message": "Access Denied: API Key is unavailable."
}

{
  "message": "Image file too large"
}

{
  "message": "Unsupported file format. Only JPEG and PNG files are supported."
}

{
  "message": "Rate limit exceeded"
}

{
  "message": "OpenAI/Gemma API Server Error"
}

Textify

Textify Templates

지원 이미지 형식

응답 시간

이미지 요구 사항

파일 크기

이미지 품질

Base64 인코딩

오류 처리

주요 오류 상황

관련 문서

소개

Textify API

인증

본문

응답

​지원 이미지 형식

​응답 시간

​이미지 요구 사항

​파일 크기

​이미지 품질

​Base64 인코딩

​오류 처리

​주요 오류 상황

​관련 문서

소개

Textify API

인증

본문

응답

지원 이미지 형식

응답 시간

이미지 요구 사항

파일 크기

이미지 품질

Base64 인코딩

오류 처리

주요 오류 상황

관련 문서