📋 변경 기록

​

2026-04-08

​

🆕 추가

• 의뢰 고유번호(uniqueId) 필드 — 모든 의뢰 관련 응답에 추가
  • 의뢰 목록(GET /v1/inquiry), 상세(GET /v1/inquiry/{id}) 응답에 포함
  • 계약, 할일 등 의뢰를 참조하는 중첩 객체에도 포함
  • UI에 표시되는 의뢰 고유번호(예: Bw4TXy1JAl)와 동일한 값
  • 읽기 전용, nullable

​

2026-03-23

​

🆕 추가

• 의뢰 파일 첨부 기능 추가
  • POST /v1/presigned — 파일 업로드용 Presigned URL 발급
  • 의뢰 생성(POST), 수정(PATCH) 시 file_set으로 파일 첨부 지원 (최대 30개)
  • 의뢰 조회(GET) 시 첨부 파일 목록 및 다운로드 URL 포함
  • DELETE /v1/inquiry/{inquiry_id}/file/{file_id} — 의뢰 첨부 파일 삭제
• 의뢰 작업 목록 API 신규 추가
  • GET /v1/inquiry/work — 의뢰 작업 목록 조회
• 로그 API 신규 추가
  • GET /v1/log/ — 로그 목록 조회

​

2026-03-06

​

🔄 변경

• 의뢰 API — fileLinkSet (링크 첨부) 필드 추가
  • 의뢰 생성(POST), 조회(GET), 수정(PATCH) 시 링크 첨부 지원
• 전체 API — nullable 필드 처리 개선 및 필수/선택 정리
  • 미입력 시 기본값이 생성되는 필드들을 nullable + optional로 변경
  • 고객: status, contact, email, inCharge 등 대부분 필드 선택으로 변경 (companyName만 필수)
  • 의뢰: client, contract, funnel, status, name 등 선택으로 변경 (미입력 시 기본값 생성)
  • 계약: endDate, startDate, client, inquiry, fieldSet 등 선택으로 변경
  • 견적서: classification, description 선택으로 변경
  • 정산: dueDate, inChargeSet, settledDate 등 선택으로 변경
  • Todo: inCharge, completedInCharge nullable 처리
  • 실무자: position nullable 처리

​

2026-03-03

​

🆕 추가

• 프로젝트 API 신규 추가
  • GET /v1/project — 프로젝트 목록 조회
  • POST /v1/project — 프로젝트 생성
  • GET /v1/project/{project_id} — 프로젝트 단일 조회
  • PATCH /v1/project/{project_id} — 프로젝트 부분 수정
  • DELETE /v1/project/{project_id} — 프로젝트 삭제
• 실무자 API 신규 추가
  • GET /v1/worker — 실무자 목록 조회
  • POST /v1/worker — 실무자 생성
  • GET /v1/worker/{worker_id} — 실무자 단일 조회
  • PATCH /v1/worker/{worker_id} — 실무자 부분 수정
  • DELETE /v1/worker/{worker_id} — 실무자 삭제
• 의뢰 히스토리 API 신규 추가
  • GET /v1/inquiry/{inquiry_id}/email_history — 의뢰 이메일 히스토리 목록 조회
  • GET /v1/inquiry/{inquiry_id}/email_reply_history — 의뢰 이메일 회신 히스토리 목록 조회
  • GET /v1/inquiry/{inquiry_id}/folder_history — 의뢰 폴더 히스토리 목록 조회
  • GET /v1/inquiry/{inquiry_id}/status_history — 의뢰 단계 히스토리 목록 조회
  • GET /v1/inquiry/{inquiry_id}/submit_history — 의뢰 웹폼 히스토리 목록 조회
  • GET /v1/inquiry/{inquiry_id}/text_history — 의뢰 텍스트 히스토리 목록 조회
  • POST /v1/inquiry/{inquiry_id}/text_history — 의뢰 텍스트 히스토리 생성
  • GET /v1/inquiry/{inquiry_id}/text_history/{history_id} — 의뢰 텍스트 히스토리 단일 조회
  • PATCH /v1/inquiry/{inquiry_id}/text_history/{history_id} — 의뢰 텍스트 히스토리 부분 수정
  • DELETE /v1/inquiry/{inquiry_id}/text_history/{history_id} — 의뢰 텍스트 히스토리 삭제

​

⚠️ Deprecated

• 의뢰 히스토리 API Deprecated
  • GET /v1/inquiry/{inquiry_id}/history → GET /v1/inquiry/{inquiry_id}/text_history 로 대체
  • POST /v1/inquiry/{inquiry_id}/history → POST /v1/inquiry/{inquiry_id}/text_history 로 대체
  • GET /v1/inquiry/{inquiry_id}/history/{history_id} → GET /v1/inquiry/{inquiry_id}/text_history/{history_id} 로 대체
  • PATCH /v1/inquiry/{inquiry_id}/history/{history_id} → PATCH /v1/inquiry/{inquiry_id}/text_history/{history_id} 로 대체
  • DELETE /v1/inquiry/{inquiry_id}/history/{history_id} → DELETE /v1/inquiry/{inquiry_id}/text_history/{history_id} 로 대체

​

🔒 보안 강화

• X-Signature 필수화 예정
  • 기존에는 X-API-KEY만으로 API에 접근할 수 있었지만, 앞으로 X-Signature 입력이 필수로 변경될 예정입니다.
  • X-Signature는 Secret Key를 기반으로 요청마다 생성되는 서명 값으로, API Key가 외부에 노출되더라도 무단 접근을 방지할 수 있습니다.
  • 정식 적용 일정은 추후 별도 공지를 통해 안내될 예정입니다. 현재 X-Signature 없이 API를 사용 중이시라면, 미리 서명 생성 로직을 적용해두시는 것을 권장합니다.
  • 자세한 서명 생성 방법은 인증 가이드를 참고해주세요.

---

​

2026-02-27

​

🆕 추가

• Todo API 신규 추가
  • GET /v1/todo — Todo 목록 조회
  • POST /v1/todo — Todo 생성
  • GET /v1/todo/{todo_id} — Todo 단일 조회
  • PATCH /v1/todo/{todo_id} — Todo 부분 수정
  • DELETE /v1/todo/{todo_id} — Todo 삭제

---

​

2026-02-25

​

🔄 변경

• 목록 조회 API에 is_hidden 필터 파라미터 추가
  • GET /v1/inquiry · GET /v1/contract · GET /v1/client · GET /v1/settlement
  • true: 숨김 항목만 조회 / false: 비숨김 항목만 조회 / 미전달: 전체 조회

---