From 862e502af3e956b49ccd2ae0a8de3fd32f90df9c Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 17 Sep 2026 20:34:56 +0900 Subject: [PATCH] =?UTF-8?q?docs(skill):=20GET=20=EC=9D=84=20=EA=B7=B8?= =?UTF-8?q?=EB=8C=80=EB=A1=9C=20=EB=90=98=EB=B3=B4=EB=82=B4=EB=A9=B4=20400?= =?UTF-8?q?=20=EC=9D=B4=EB=9D=BC=EB=8A=94=20=EA=B2=83=EC=9D=84=20PUT=20?= =?UTF-8?q?=EC=84=A4=EB=AA=85=20=EC=98=86=EC=97=90=20=EC=A0=81=EB=8A=94?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit `references/studio-api.md` 는 「서버가 주지만 보내지 않는 것: id · version · updatedAt」을 이미 적고 있었는데, 그 문장이 PUT 요청 모양을 설명하는 절이 아니라 한 절 아래 「종류마다의 칸」에 있었다. 2026-09-17 에 서로 다른 두 작업이 같은 자리에서 400 VALIDATION_FAILED / UnrecognizedPropertyException 을 맞았다 — 둘 다 GET 으로 받은 document 를 그대로 되보냈다. 내용을 더한 것이 아니라 PUT 을 설명하는 자리에서 그 표를 가리키게 했다. 서버 상태는 안 바뀌므로 셋을 빼고 다시 보내면 된다는 것도 적었다. Co-Authored-By: Claude Opus 5 (1M context) --- .../publishing-tech-log-to-studio/references/studio-api.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/.agents/skills/publishing-tech-log-to-studio/references/studio-api.md b/.agents/skills/publishing-tech-log-to-studio/references/studio-api.md index d4b59e9..830dbe7 100644 --- a/.agents/skills/publishing-tech-log-to-studio/references/studio-api.md +++ b/.agents/skills/publishing-tech-log-to-studio/references/studio-api.md @@ -87,6 +87,11 @@ body: { "expectedVersion": <읽어 온 document.version>, "document": { … } `document` 는 **그 종류의 칸을 전부** 담는다. 빠뜨린 칸은 비는 것으로 저장된다 — 부분 갱신이 아니다. +**다만 `GET` 으로 받은 것을 그대로 되보내면 400 이다.** `id` · `version` · `updatedAt` 은 서버가 +주기만 하고 받지는 않아서, 그 셋이 들어 있으면 `VALIDATION_FAILED` 와 +`UnrecognizedPropertyException` 으로 거절된다(2026-09-17 에 두 번 겪었다). 서버 상태는 안 +바뀌니 셋을 빼고 다시 보내면 된다. 어느 칸을 보내고 어느 칸을 빼는지는 바로 아래 표에 있다. + ## 종류마다의 칸 여섯이 함께 갖는 것: `kind` · `title` · `slug` · `summary` · `relations` · `projectId` ·