📋 변경 기록

​

2026-10-29

​

🔄 변경

• 인증을 API Key 하나로 단순화 — X-Signature(요청 본문 HMAC 서명)가 더 이상 필요하지 않습니다. X-API-KEY 헤더만 넣으면 됩니다.
  • 기존 연동에서 X-Signature를 계속 보내도 무시되므로 수정 없이 그대로 동작합니다
  • 새로 발급하는 API Key에는 Secret Key가 없습니다
  • 스펙의 보안 정의에서 Signature가 빠지고 ApiKeyAuth만 남았습니다
  • MCP wrapper도 API Key 하나만 입력하면 됩니다

​

2026-10-27

​

🆕 추가

• 의뢰 숨김 여부 조회·지정 — 웹 화면에서만 가능하던 의뢰 숨김/숨김 해제를 API로 할 수 있습니다.
  • 의뢰 목록·상세·생성·수정 응답에 isHidden(숨김 여부, true/false)이 포함됩니다
  • 의뢰 수정(PATCH /v1/inquiry/{inquiry_id}) 본문에 isHidden을 보내면 숨기거나(true) 숨김을 풉니다(false). 생략하면 그대로 유지됩니다
  • 의뢰 생성(POST /v1/inquiry)에서도 isHidden을 지정할 수 있으며, 생략하면 false입니다
  • 숨김 여부만 바꾸면 단계·폴더 이력, 담당자 알림, 의뢰 변경 웹훅이 발생하지 않습니다
  • 의뢰 목록의 is_hidden 필터로 숨긴 의뢰만(또는 숨기지 않은 의뢰만) 조회할 수 있습니다

​

🔄 변경

• 계약 수정 시 상태 자동 반영 — 계약 부분 수정(PATCH /v1/contract/{contract_id})이 종료일과 정산 유무로 status를 다시 정합니다. 웹 화면에서 계약을 수정할 때와 같은 규칙입니다.
  • 정산이 있는 계약의 종료일을 지난 날짜로 바꾸면 바로 C(계약 종료), 오늘 이후로 바꾸면 I(정산 진행 중)
  • 정산이 없는 계약, 계약 중단(T) 계약, 종료일이 비어 있는 계약은 상태가 바뀌지 않습니다
  • 규칙 상세는 계약 부분 수정 참고
• 자정 자동 종료 시점 — 계약 종료일은 당일까지 유효합니다. 종료일이 지난 I(정산 진행 중) 계약은 종료일 다음 날 자정(한국 시간)에 C(계약 종료)로 바뀝니다. 이전에는 종료일 당일 자정에 바뀌었습니다.

​

2026-10-14

​

🔄 변경

• 오류 응답 형식 안내 정정 — 오류 응답은 detail(입력 오류는 필드별 메시지 목록) 형식이며, 실제 응답 형식은 바뀌지 않았습니다.
  • 호출 횟수 제한(429) 예시를 실제 응답 {"detail": "..."}로 수정. 대기 시간은 Retry-After 헤더로도 받을 수 있습니다
• 이력·메모 응답 member null 허용 표기 — 단계·폴더·이메일 이력 목록과 의뢰·계약·정산 메모 단건 응답의 member를 스펙에서 null 허용으로 정정. 오픈 API로 만든 메모처럼 작성 멤버가 없으면 null이며, 실제 응답 값은 바뀌지 않았습니다.

​

2026-10-13

​

🔄 변경

• 삭제된 데이터 비노출 — 삭제(휴지통)된 계약·고객·의뢰가 다른 응답에 더 이상 포함되지 않습니다. 응답 스키마(필드·타입)는 그대로입니다.
  • 의뢰 응답의 contract·client, 계약 응답의 inquiry·client, 프로젝트 응답의 contract는 연결된 대상이 삭제됐으면 null (조회·생성·수정 응답 모두)
  • 의뢰는 속한 폴더가 삭제된 경우도 삭제된 것으로 봅니다
  • 삭제된 의뢰의 할 일·이력(상태·폴더·웹폼 제출·이메일·이메일 답장)·텍스트 히스토리, 삭제된 계약·정산의 텍스트 히스토리는 목록이 비어 있고, 단건 조회·수정·삭제는 404
  • 의뢰 목록 search는 삭제된 고객의 회사명·담당자·연락처·이메일로는 찾지 않습니다
  • 계약 목록을 삭제된 의뢰·고객으로 거르면(inquiry_id, client_id) 빈 목록
  • 삭제된 대상이 복원되면 다시 포함됩니다. 단, 수정 요청에서 해당 항목을 null로 보내면 연결이 해제되어 복원해도 돌아오지 않습니다

​

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: 비숨김 항목만 조회 / 미전달: 전체 조회

---