외부 고객 접수 API 문서
인증
모든 API 요청에는 Authorization 헤더가 필요합니다.
Authorization: Bearer {API_KEY}API 키는 API 키 관리 페이지에서 발급받을 수 있습니다.
POST /api/external/receive_customer
고객을 접수합니다. 접수된 고객은 백그라운드에서 자동 분류됩니다.
공통 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| name | string | 필수 | 고객명 |
| customer_type | integer | 필수 | 1: 부동산, 2: 자동차, 3: 개인회생, 4: 메모접수 |
| birthday | string | 필수 | 생년월일 (YYYYMMDD) |
| job_code | integer | 필수 | 1: 개인사업자, 2: 직장인, 3: 프리랜서, 4: 주부, 5: 무직, 27: 기타 |
| company_code | string | 필수 | 대리점 UID. API 키 관리 페이지에서 확인 가능 |
| uid | string | 선택 | 외부 고유번호 (미입력 시 자동생성) |
| phone | string | 선택 | 전화번호 예시만 사용 |
| etc_memo | string | 선택 | 메모 (customer_type=4일 때 확인 필요) |
부동산 (customer_type=1) 추가 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| address | string | 선택 | 담보물 주소 예시 |
| living_type | string | 선택 | 본인거주 / 전세 / 월세 / 무상거주 |
| deposit | integer | 선택 | 임차보증금 (만원) |
자동차 (customer_type=2) 추가 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| car_no | string | 선택 | 차량번호 예시 |
개인회생 (customer_type=3) 추가 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
| court_name | string | 선택 | 관할법원 예시 |
| case_no | string | 선택 | 사건번호 예시 |