Glowb Dev Docs
Main APIAI API

POST /ai/business/license/check

사업자등록증 분석 + 중복 가입 확인 (회원가입 플로우)

사업자등록증 분석 + 중복 가입 확인

기업 회원가입 플로우용 API. 업로드된 사업자등록증 파일을 저장하지 않고 분석만 수행한 뒤, 추출된 사업자등록번호로 동일 사업자번호의 기가입 계정이 존재하는지 반환합니다.

항목
메서드POST
경로/ai/business/license/check
인증불필요
Content-Typemultipart/form-data

동작

  • 업로드된 파일을 Python AI 백엔드(/api/business/parse-license/upload)에 multipart 로 전달합니다.
  • 파일은 S3 등 영구 저장소에 저장되지 않으며, 메모리에서만 처리됩니다.
  • 응답이 is_business_license=false 인 경우 모든 필드를 빈 값으로, exists=false 로 반환합니다.
  • is_business_license=true 이면 추출된 business_registration_numberTB_BUSINESS.license 컬럼을 조회하여 기가입 여부를 결정합니다.

요청

POST /ai/business/license/check HTTP/1.1
Host: api.glowb.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary
curl -X POST "https://api.glowb.com/ai/business/license/check" \
  -F "file=@license.jpg"
const formData = new FormData();
formData.append('file', licenseFile);

const response = await fetch('/ai/business/license/check', {
  method: 'POST',
  body: formData
});
const result = await response.json();

Request Parts

Prop

Type

응답

성공 응답 (200 OK)

사업자등록증으로 판별되고 기가입자가 있는 경우:

{
  "status": 200,
  "code": null,
  "message": "사업자등록증 분석 완료",
  "data": {
    "isBusinessLicense": true,
    "country": "KR",
    "companyName": "주식회사 글로우비",
    "companyAddress": "서울특별시 ...",
    "businessRegistrationNumber": "123-45-67890",
    "exists": true,
    "existingMemberId": "abc123"
  }
}

사업자등록증으로 판별되었으나 기가입자가 없는 경우:

{
  "status": 200,
  "code": null,
  "message": "사업자등록증 분석 완료",
  "data": {
    "isBusinessLicense": true,
    "country": "KR",
    "companyName": "주식회사 글로우비",
    "companyAddress": "서울특별시 ...",
    "businessRegistrationNumber": "123-45-67890",
    "exists": false
  }
}

사업자등록증이 아닌 문서로 판별된 경우:

{
  "status": 200,
  "code": null,
  "message": "사업자등록증 분석 완료",
  "data": {
    "isBusinessLicense": false,
    "country": "",
    "companyName": "",
    "companyAddress": "",
    "businessRegistrationNumber": "",
    "exists": false
  }
}

에러 응답

상태 코드code설명
400BUSINESS_LICENSE_FILE_REQUIRED파일이 누락되었거나 비어있음
500BUSINESS_LICENSE_CHECK_FAILEDPython 분석 API 호출 실패 등 내부 오류

관련 API

API 테스트

On this page