docs(skill): GET 을 그대로 되보내면 400 이라는 것을 PUT 설명 옆에 적는다
`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) <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
b1a78752df
commit
862e502af3
@@ -87,6 +87,11 @@ body: { "expectedVersion": <읽어 온 document.version>, "document": { … }
|
|||||||
`document` 는 **그 종류의 칸을 전부** 담는다. 빠뜨린 칸은 비는 것으로 저장된다 — 부분 갱신이
|
`document` 는 **그 종류의 칸을 전부** 담는다. 빠뜨린 칸은 비는 것으로 저장된다 — 부분 갱신이
|
||||||
아니다.
|
아니다.
|
||||||
|
|
||||||
|
**다만 `GET` 으로 받은 것을 그대로 되보내면 400 이다.** `id` · `version` · `updatedAt` 은 서버가
|
||||||
|
주기만 하고 받지는 않아서, 그 셋이 들어 있으면 `VALIDATION_FAILED` 와
|
||||||
|
`UnrecognizedPropertyException` 으로 거절된다(2026-09-17 에 두 번 겪었다). 서버 상태는 안
|
||||||
|
바뀌니 셋을 빼고 다시 보내면 된다. 어느 칸을 보내고 어느 칸을 빼는지는 바로 아래 표에 있다.
|
||||||
|
|
||||||
## 종류마다의 칸
|
## 종류마다의 칸
|
||||||
|
|
||||||
여섯이 함께 갖는 것: `kind` · `title` · `slug` · `summary` · `relations` · `projectId` ·
|
여섯이 함께 갖는 것: `kind` · `title` · `slug` · `summary` · `relations` · `projectId` ·
|
||||||
|
|||||||
Reference in New Issue
Block a user