# [MOFIT]OpenAPIs

## Docs
- 모홈 [보장분석](https://developer.mofit.im/%EB%B3%B4%EC%9E%A5%EB%B6%84%EC%84%9D-3598734f0.md): 

## API Docs
- 공통 [SSO 로그인 (리다이렉트)](https://developer.mofit.im/sso-%EB%A1%9C%EA%B7%B8%EC%9D%B8-%EB%A6%AC%EB%8B%A4%EC%9D%B4%EB%A0%89%ED%8A%B8-29812136e0.md): 발급한 JWT로 로그인 후 프론트엔드로 302 리다이렉트합니다.
- 공통 [인증토큰 발급](https://developer.mofit.im/%EC%9D%B8%EC%A6%9D%ED%86%A0%ED%81%B0-%EB%B0%9C%EA%B8%89-21599027e0.md): 
- 모홈 > 사용자 관리 [사용자 목록 조회](https://developer.mofit.im/%EC%82%AC%EC%9A%A9%EC%9E%90-%EB%AA%A9%EB%A1%9D-%EC%A1%B0%ED%9A%8C-40714980e0.md): 
- 모홈 > 사용자 관리 [사용자 생성](https://developer.mofit.im/%EC%82%AC%EC%9A%A9%EC%9E%90-%EC%83%9D%EC%84%B1-40714981e0.md): 사용자를 생성합니다.
- 모홈 > 사용자 관리 [사용자 변경](https://developer.mofit.im/%EC%82%AC%EC%9A%A9%EC%9E%90-%EB%B3%80%EA%B2%BD-40714982e0.md): 사용자 정보를 변경합니다.
- 모홈 > 사용자 관리 [사용자 제거](https://developer.mofit.im/%EC%82%AC%EC%9A%A9%EC%9E%90-%EC%A0%9C%EA%B1%B0-40714983e0.md): 사용자를 조직에서 제거합니다.
- 모홈 > 조직 관리 [조직도 조회](https://developer.mofit.im/%EC%A1%B0%EC%A7%81%EB%8F%84-%EC%A1%B0%ED%9A%8C-40714863e0.md): 
- 모홈 > 조직 관리 [조직 생성](https://developer.mofit.im/%EC%A1%B0%EC%A7%81-%EC%83%9D%EC%84%B1-40714864e0.md): 
- 모홈 > 조직 관리 [조직 변경](https://developer.mofit.im/%EC%A1%B0%EC%A7%81-%EB%B3%80%EA%B2%BD-40714865e0.md): 조직 정보를 변경합니다.
- 모홈 > 조직 관리 [조직 삭제](https://developer.mofit.im/%EC%A1%B0%EC%A7%81-%EC%82%AD%EC%A0%9C-40714866e0.md): 조직을 삭제합니다.
- 모홈 > 청구 [보험사 목록](https://developer.mofit.im/%EB%B3%B4%ED%97%98%EC%82%AC-%EB%AA%A9%EB%A1%9D-21834114e0.md): 
- 모홈 > 청구 [은행 목록](https://developer.mofit.im/%EC%9D%80%ED%96%89-%EB%AA%A9%EB%A1%9D-21834146e0.md): 
- 모홈 > 청구 [우체국 지급센터 목록](https://developer.mofit.im/%EC%9A%B0%EC%B2%B4%EA%B5%AD-%EC%A7%80%EA%B8%89%EC%84%BC%ED%84%B0-%EB%AA%A9%EB%A1%9D-21834160e0.md): 
- 모홈 > 청구 [직업 코드 목록 [x]](https://developer.mofit.im/%EC%A7%81%EC%97%85-%EC%BD%94%EB%93%9C-%EB%AA%A9%EB%A1%9D-x-21891864e0.md): 
- 모홈 > 청구 [약관 조회 [x]](https://developer.mofit.im/%EC%95%BD%EA%B4%80-%EC%A1%B0%ED%9A%8C-x-21834429e0.md): 
- 모홈 > 청구 [청구](https://developer.mofit.im/%EC%B2%AD%EA%B5%AC-19758201e0.md): 
- 모홈 > 청구 [청구 이력](https://developer.mofit.im/%EC%B2%AD%EA%B5%AC-%EC%9D%B4%EB%A0%A5-21834806e0.md): 
- 모홈 > 보장분석 [본인인증 - 인증번호 요청](https://developer.mofit.im/%EB%B3%B8%EC%9D%B8%EC%9D%B8%EC%A6%9D-%EC%9D%B8%EC%A6%9D%EB%B2%88%ED%98%B8-%EC%9A%94%EC%B2%AD-16337572e0.md): 
- 모홈 > 보장분석 [본인인증 - 인증번호 검증](https://developer.mofit.im/%EB%B3%B8%EC%9D%B8%EC%9D%B8%EC%A6%9D-%EC%9D%B8%EC%A6%9D%EB%B2%88%ED%98%B8-%EA%B2%80%EC%A6%9D-16337573e0.md): 
- 모홈 > 보장분석 [약관조회](https://developer.mofit.im/%EC%95%BD%EA%B4%80%EC%A1%B0%ED%9A%8C-16337574e0.md): 
- 모홈 > 보장분석 [보장분석 결과](https://developer.mofit.im/%EB%B3%B4%EC%9E%A5%EB%B6%84%EC%84%9D-%EA%B2%B0%EA%B3%BC-16337575e0.md): 
- 모홈 > 보장분석 [보장분석 결과 리포트](https://developer.mofit.im/%EB%B3%B4%EC%9E%A5%EB%B6%84%EC%84%9D-%EA%B2%B0%EA%B3%BC-%EB%A6%AC%ED%8F%AC%ED%8A%B8-16337576e0.md): 
- 모홈 > 메디컬보장분석 [건강보험공단 - 간편인증 요청](https://developer.mofit.im/%EA%B1%B4%EA%B0%95%EB%B3%B4%ED%97%98%EA%B3%B5%EB%8B%A8-%EA%B0%84%ED%8E%B8%EC%9D%B8%EC%A6%9D-%EC%9A%94%EC%B2%AD-21597063e0.md): 건강보험공단에 간편인증 로그인을 요청합니다.
- 모홈 > 메디컬보장분석 [건강보험공단 - 간편인증 완료](https://developer.mofit.im/%EA%B1%B4%EA%B0%95%EB%B3%B4%ED%97%98%EA%B3%B5%EB%8B%A8-%EA%B0%84%ED%8E%B8%EC%9D%B8%EC%A6%9D-%EC%99%84%EB%A3%8C-21599279e0.md): 건강보험공단 간편인증 정보로 인증 완료 처리하고 건강검진, 투약정보 데이터를 요청합니다.
- 모홈 > 메디컬보장분석 [건강검진 데이터 조회](https://developer.mofit.im/%EA%B1%B4%EA%B0%95%EA%B2%80%EC%A7%84-%EB%8D%B0%EC%9D%B4%ED%84%B0-%EC%A1%B0%ED%9A%8C-36281576e0.md): [건강보험공단 - 간편인증 완료] 에서 요청한 건강검진 데이터를 조회합니다.
- 모홈 > 메디컬보장분석 [보장분석 결과 전송](https://developer.mofit.im/%EB%B3%B4%EC%9E%A5%EB%B6%84%EC%84%9D-%EA%B2%B0%EA%B3%BC-%EC%A0%84%EC%86%A1-21599283e0.md): 모홈 보장분석 APIs - [보장분석 결과] 응답 데이터를 메디컬보장분석으로 전송합니다.
- 모홈 > 메디컬보장분석 [PDF 리포트 요청](https://developer.mofit.im/pdf-%EB%A6%AC%ED%8F%AC%ED%8A%B8-%EC%9A%94%EC%B2%AD-21599287e0.md): 메디컬 보장분석 PDF 리포트 생성을 요청합니다.
- 모홈 > 메디컬보장분석 [JSON 리포트 요청](https://developer.mofit.im/json-%EB%A6%AC%ED%8F%AC%ED%8A%B8-%EC%9A%94%EC%B2%AD-21599434e0.md): 메디컬 보장분석 JSON 리포트 생성을 요청합니다.
- LDBDS v1 [상품 AS 정책 조회](https://developer.mofit.im/%EC%83%81%ED%92%88-as-%EC%A0%95%EC%B1%85-%EC%A1%B0%ED%9A%8C-38800890e0.md): 상품별 AS 안내 텍스트 조회. 어드민 상품 화면에서 저장한 내용과 동일.
- LDBDS v1 [지역 허용값 목록](https://developer.mofit.im/%EC%A7%80%EC%97%AD-%ED%97%88%EC%9A%A9%EA%B0%92-%EB%AA%A9%EB%A1%9D-38800891e0.md): 시스템에 정의된 지역 문자열 목록. 주문 생성 시 regionQuantities 등에 이 값만 사용하는 것을 권장합니다.
- LDBDS v1 [주문 목록·통계](https://developer.mofit.im/%EC%A3%BC%EB%AC%B8-%EB%AA%A9%EB%A1%9D%ED%86%B5%EA%B3%84-38800892e0.md): 모홈 사용자(mohomId)별 주문 목록과 요약 통계. 목록은 페이지네이션, summary는 동일 필터(status·조회기간) 기준 전체 합계. userId는 mohomId와 동의어 쿼리.
- LDBDS v1 [주문 등록](https://developer.mofit.im/%EC%A3%BC%EB%AC%B8-%EB%93%B1%EB%A1%9D-38800893e0.md): 모홈 주문 등록. API Key 인증 필요.
- LDBDS v1 [주문 단건 조회](https://developer.mofit.im/%EC%A3%BC%EB%AC%B8-%EB%8B%A8%EA%B1%B4-%EC%A1%B0%ED%9A%8C-38800894e0.md): 경로의 주문 ID와 쿼리의 mohomId(또는 userId)가 일치할 때만 조회. 목록 항목과 동일 필드.
- LDBDS v1 [주문 취소](https://developer.mofit.im/%EC%A3%BC%EB%AC%B8-%EC%B7%A8%EC%86%8C-38800895e0.md): 주문 취소. 가배정은 자동 회수, 확정배정은 유지한 채 주문만 취소 처리. 환불 시 호출. 선택적으로 memo로 주문 메모를 갱신할 수 있음(미전달 시 기존 메모 유지).
- LDBDS v1 [소유 DB 리스트](https://developer.mofit.im/%EC%86%8C%EC%9C%A0-db-%EB%A6%AC%EC%8A%A4%ED%8A%B8-38800896e0.md): mohomId별 소유 DB 목록. used 필터( true: 사용완료만, false: 미사용만 ). hasAs=true(또는 Y)면 **가장 최근 AS 1건**(createdAt 내림차순, 동률 시 id)이 CANCELLED가 아닌 DB만. 마스킹 적용 (사용처리 시 해제). region·gender 필터, search(이름·연락처 끝자리 phone_3·이메일·메모·상품명 부분일치), sortBy(assignedAt|usedAt|age)·sortOrder(asc|desc). assignedAt 정렬은 Lead.lastDistributedAt 기준. 나이순(age)은 생년월일(YYMMDD) 문자열 기준 정렬. 응답 각 항목에 최신 AS 상태 `leadAsStatus`·`leadAsStatusLabel` 및(마스킹 전개 시) `leadAs` 배열이 포함될 수 있음.
- LDBDS v1 [DB 단건 등록](https://developer.mofit.im/db-%EB%8B%A8%EA%B1%B4-%EB%93%B1%EB%A1%9D-38800897e0.md): 내부 POST /api/leads와 동일한 검증(상품·공급처 매핑, 필수 필드, 연락처·주민번호 형식, 공급처별 연락처 중복). providerId 필수. 등록자(createdBy)는 시스템 연동이므로 null. mohomId를 넣으면 동일 공급처·상품·mohom의 PENDING/IN_PROGRESS 주문이 있으면 그 주문에 확정 배정하고, 없으면 총량 100만 건 주문을 생성한 뒤 1건 확정 배정한다.
- LDBDS v1 [기분배 DB 리스트](https://developer.mofit.im/%EA%B8%B0%EB%B6%84%EB%B0%B0-db-%EB%A6%AC%EC%8A%A4%ED%8A%B8-38800898e0.md): mohomId가 분배한 DB 목록 (현재 타인 소유, recall 가능). 분배한 사람만 조회하므로 연락처·이메일은 사용처리 여부와 무관 항상 마스킹. used 필터, providerId(조직=공급처) 필터, hasAs(Y: 소유 DB 리스트와 동일·최근 AS 1건이 CANCELLED 아님), search, sortBy(distributedAt|usedAt)·sortOrder. distributedAt 정렬은 Lead.lastDistributedAt 기준(소유 DB 리스트 assignedAt 정렬과 동일). hasAs=Y이면서 sortBy=usedAt일 때도 SQL 경로로 동일 필터 적용. 응답 항목에 소유 DB 리스트와 동일하게 `leadAsStatus`·`leadAsStatusLabel`(최신 AS 1건) 포함.
- LDBDS v1 [소유 DB 단건 조회](https://developer.mofit.im/%EC%86%8C%EC%9C%A0-db-%EB%8B%A8%EA%B1%B4-%EC%A1%B0%ED%9A%8C-38800899e0.md): 특정 DB 상세 조회. 마스킹 적용 (사용처리 시 해제). `metadata`는 파일 CDN URL 보강 후 반환. `leadAsStatus`·`leadAsStatusLabel`(최신 AS 1건), Lead 전개 필드로 `leadAs`가 포함될 수 있음.
- LDBDS v1 [DB 사용처리](https://developer.mofit.im/db-%EC%82%AC%EC%9A%A9%EC%B2%98%EB%A6%AC-38800900e0.md): 고객이 DB 수신 후 사용 버튼 클릭 시. 마스킹 해제. `distribute`와 동일하게 `leadIds` 배열로 일괄 처리 가능.
- LDBDS v1 [Lead ID 목록으로 이름·연락처(복호화) 조회](https://developer.mofit.im/lead-id-%EB%AA%A9%EB%A1%9D%EC%9C%BC%EB%A1%9C-%EC%9D%B4%EB%A6%84%EC%97%B0%EB%9D%BD%EC%B2%98%EB%B3%B5%ED%98%B8%ED%99%94-%EC%A1%B0%ED%9A%8C-38800901e0.md): 요청한 Lead ID 각각에 대해 `name`과 복호화된 `phone`(전체 번호)을 반환합니다. `POST /api/v1/leads/use`와 동일하게, 해당 모홈에 **확정 배정(CONFIRMED)** 및 소유가 있는 Lead만 조회됩니다.
- LDBDS v1 [파일 업로드 Presigned URL 발급](https://developer.mofit.im/%ED%8C%8C%EC%9D%BC-%EC%97%85%EB%A1%9C%EB%93%9C-presigned-url-%EB%B0%9C%EA%B8%89-38800902e0.md): AS 신청 증빙 파일 업로드용. 1) 이 API로 fileId·uploadUrl 획득 → 2) PUT으로 S3 업로드 → 3) AS 신청 시 storedFileIds에 fileId 포함
- LDBDS v1 [AS 사유 코드 목록](https://developer.mofit.im/as-%EC%82%AC%EC%9C%A0-%EC%BD%94%EB%93%9C-%EB%AA%A9%EB%A1%9D-38800903e0.md): AS 신청 시 reasonCode로 사용할 수 있는 코드·한글 라벨 목록. 신청 UI 구성 시 참고.
- LDBDS v1 [AS 신청 리스트](https://developer.mofit.im/as-%EC%8B%A0%EC%B2%AD-%EB%A6%AC%EC%8A%A4%ED%8A%B8-38800904e0.md): 모홈 ID에 해당하는 AS 신청 목록 (현재 소유 중인 DB의 AS). `leadId`를 주면 해당 Lead(DB) ID로 소유 범위를 한정(본인 소유가 아니면 빈 목록). search로 성함·연락처(phone_3)·상품명·고객 메모(customerMemo)·사유 코드/한글 라벨 부분일치 검색.
- LDBDS v1 [AS 신청](https://developer.mofit.im/as-%EC%8B%A0%EC%B2%AD-38800905e0.md): 고객정보, DB ID, 증빙 파일 IDs, 사유로 AS 신청
- LDBDS v1 [AS 신청 단건 조회](https://developer.mofit.im/as-%EC%8B%A0%EC%B2%AD-%EB%8B%A8%EA%B1%B4-%EC%A1%B0%ED%9A%8C-38800906e0.md): LeadAs ID로 조회(기본), 또는 by=lead로 Lead ID를 넣어 해당 DB의 가장 최근 AS 1건을 조회. files는 AS 신청 시 첨부된 증빙만(stored_files refType=lead_as, Lead.metadata와 무관).
- LDBDS v1 [AS 신청 취소](https://developer.mofit.im/as-%EC%8B%A0%EC%B2%AD-%EC%B7%A8%EC%86%8C-38800907e0.md): 대기/보류 상태의 AS만 취소 가능. 성공 시 상태는 CANCELLED(취소)로 저장됩니다.
- LDBDS v1 [DB 분배](https://developer.mofit.im/db-%EB%B6%84%EB%B0%B0-38800908e0.md): 모홈 고객이 타 고객 mohomId에게 DB 분배
- LDBDS v1 [DB 분배 회수](https://developer.mofit.im/db-%EB%B6%84%EB%B0%B0-%ED%9A%8C%EC%88%98-38800909e0.md): 타고객에게 분배한 DB 회수. 사용처리 전만 가능.

## Schemas
- [SsoLoginRequest](https://developer.mofit.im/ssologinrequest-13327395d0.md): 
- [TokenResponse](https://developer.mofit.im/tokenresponse-13327420d0.md): 
- [ProductAsPolicyResponse](https://developer.mofit.im/productaspolicyresponse-16082316d0.md): 
- [OrgChartNode](https://developer.mofit.im/orgchartnode-16657351d0.md): 
- [UserSummary](https://developer.mofit.im/usersummary-16704825d0.md): 
- [SsoLoginResponse](https://developer.mofit.im/ssologinresponse-13327396d0.md): 
- [ErrorResponse](https://developer.mofit.im/errorresponse-13327397d0.md): 
- [Error](https://developer.mofit.im/error-16082317d0.md): 
- [InsertUserBody](https://developer.mofit.im/insertuserbody-16704826d0.md): 
- [RegionsResponse](https://developer.mofit.im/regionsresponse-16082318d0.md): 
- [UpdateUserBody](https://developer.mofit.im/updateuserbody-16704827d0.md): 
- [OrdersListWithSummaryResponse](https://developer.mofit.im/orderslistwithsummaryresponse-16082319d0.md): 
- [OrderListItem](https://developer.mofit.im/orderlistitem-16082320d0.md): 
- [Order](https://developer.mofit.im/order-16082321d0.md): 
- [CreateOrderRequest](https://developer.mofit.im/createorderrequest-16082322d0.md): 
- [RegionQuantity](https://developer.mofit.im/regionquantity-16082323d0.md): 
- [LeadsListResponse](https://developer.mofit.im/leadslistresponse-16082324d0.md): 
- [Lead](https://developer.mofit.im/lead-16082325d0.md): 
- [LeadCreated](https://developer.mofit.im/leadcreated-16082326d0.md): 
- [CreateLeadV1Request](https://developer.mofit.im/createleadv1request-16082327d0.md): 
- [PresignedRequest](https://developer.mofit.im/presignedrequest-16082328d0.md): 
- [AsReasonsResponse](https://developer.mofit.im/asreasonsresponse-16082329d0.md): 
- [AsListItem](https://developer.mofit.im/aslistitem-16082330d0.md): 
- [AsDetail](https://developer.mofit.im/asdetail-16082331d0.md): 
- [CreateAsRequest](https://developer.mofit.im/createasrequest-16082332d0.md): 
- [DistributeRequest](https://developer.mofit.im/distributerequest-16082333d0.md): 
- [RecallRequest](https://developer.mofit.im/recallrequest-16082334d0.md):