성공 응답은 공개를 보장하지 않습니다 — 글 11편이 전부 초안으로 떨어졌던 기록
2026.08.12
게시 자동화 편 · 에이전트 하네스 시리즈 중 하나입니다.
⚠ 먼저 밝혀둡니다. 이 글은 "API로 글을 올렸다"는 성공담이 아닙니다. 성공 응답을 받고도 글이 공개되지 않은 사건에서 출발합니다. 서버는 글 식별자와 주소까지 돌려줬는데, 글은 초안 상태로 아무에게도 보이지 않았습니다. 그 상태를 어떻게 진단했고, 사후 공개 경로가 전부 막힌 것을 어떻게 확인했고, 결국 어떤 지렛대로 열었는지의 기록입니다. 수치는 전부 당일 실행 출력에서 왔습니다.
1. 시작은 "성공했는데 아무도 못 보는 글"이었습니다
준비를 끝낸 글 여러 편을 커뮤니티의 공개 API로 게시했습니다. 서버 응답은 정상이었습니다 — 글 식별자, 주소, 오류 없음. 그런데 응답의 상태란에 DRAFT가 찍혀 있었습니다. 작성자 토큰으로는 글이 열리니 얼핏 성공으로 보이지만, 로그인 안 한 방문자에게는 존재하지 않는 글입니다.
여기서 무서운 것은 실패가 조용하다는 점입니다. 오류가 났다면 바로 고쳤을 텐데, 모든 신호가 성공을 가리키면서 결과만 비공개였습니다. 자동화가 이 상태로 수십 편을 쏟아냈다면, 게시했다고 믿는 글 수십 편이 통째로 유령이 됐을 것입니다.
2. 그래서 이번에 정한 질문 하나
"왜 안 되지"가 아니었습니다. 질문은 둘로 쪼갰습니다. 초안을 사후에 공개로 바꾸는 길이 이 계정에 있는가. 없다면 생성 시점에 공개 상태로 만드는 길이 있는가. 앞 질문은 권한 조회로, 뒤 질문은 스키마 조회로 — 둘 다 추측이 아니라 서버에게 직접 물어 답할 수 있는 질문입니다.
3. 사용한 개념과 도구 — 서버에게 직접 묻는 세 가지 방법
밖에서 보면 이 시스템에 들어오는 것은 게이트를 통과한 원고이고, 나가는 것은 공개 상태가 검증된 게시 URL입니다. 그 사이의 진단은 전부 서버 질의였습니다 — 글 단위 권한 조회(무엇이 허용되는가), 스키마 조회(입력에 어떤 필드가 실존하는가), 그리고 최소 재현 글(가설을 실물로 확인).
발사 원고 페이로드 → 생성 요청 → 식별자·상태 → 상태가 공개인가
진단 글 식별자 → 글 단위 권한 조회 → 허용/거부 목록 → 사후 공개 길이 있는가
스키마 입력 타입 → 폐기 필드 포함 조회 → 필드 실존 여부 → 생성 시 지렛대가 있는가
검증 게시된 글 → 남의 토큰으로 재조회 → 제목·상태 대조 → 방문자에게 보이는가4. 실제로 만든 것 — 기능 세 개와, 그 기능이 막는 실패
① 실패를 최소 재현 글로 좁혔다 — 진짜 원고로 실험하다 게시판을 어지럽히는 것을 막는다
가설을 시험할 때마다 진짜 원고를 쏘면, 실험 흔적이 커뮤니티에 그대로 노출됩니다. 그래서 "진단용, 곧 삭제됩니다"라고 명시한 두 문장짜리 최소 글을 만들어 상태를 확인하고 즉시 지웠습니다. 이 최소 글 두 번으로 두 가설 — 요청 맥락을 브라우저와 똑같이 맞추면 되는가(아니었습니다), 폐기된 공개 플래그가 아직 동작하는가(맞았습니다) — 을 각각 확정했습니다. 실험의 부산물이 게시판에 남은 시간은 회당 몇 초였습니다.
② 재발급 토큰의 신원을 열어서 확인했다 — 손님 토큰이 회원 행세하는 것을 막는다
게시 토큰은 수명이 5분이라 갱신 토큰으로 자동 재발급하는데, 여기 함정이 있었습니다. 갱신 토큰을 잘못된 형태(주소 인코딩이 남은 상태)로 보내면 서버가 오류를 내는 게 아니라 조용히 손님 등급 토큰을 내려줍니다. 그 토큰으로 게시를 시도하면 그때서야 권한 오류가 나서, 원인이 토큰 단계에 있다는 것이 가려집니다. 그래서 재발급 직후 토큰 내용을 열어 등급이 회원인지 확인하고, 아니면 그 자리에서 실패시키게 했습니다.
③ 발사 후 남의 눈으로 다시 읽었다 — 성공 응답을 공개로 착각하는 것을 막는다
이번 사건의 교훈 그 자체입니다. 작성자 토큰으로는 초안도 열리므로, 작성자 토큰의 재조회는 공개 검증이 아닙니다. 그래서 발사 직후 로그인 없는 손님 토큰을 새로 받아 같은 글을 조회하고, 제목과 공개 상태가 일치할 때만 성공으로 기록합니다. 하나라도 어긋나면 그 자리에서 멈춥니다. 방문자에게 보이는가는 방문자의 눈으로만 확인됩니다.
5. 지금까지 관찰된 결과 (실측 · 명령을 같이 적습니다)
사후 공개 경로의 권한 조회 결과입니다. 글 단위 권한 목록에서 발췌했습니다 (스크립트 실행 출력 · 도구 버전은 --version 류로 기록).
| 경로 | 결과 | 뜻 |
|---|---|---|
| 사후 공개 요청 | 거부 (권한 없음) | 초안→공개 전환은 관리자 전용 |
| 갱신으로 공개일 주입 | 거부 (권한 없음) | 우회로도 막힘 |
| 초안 생성 자체 | 거부 (권한 없음) | 초안 기능 전체가 관리자 영역 |
| 생성 시 공개 플래그 | 동작 | 폐기 표시된 필드지만 유일하게 열린 길 |
발사 결과입니다.
| 항목 | 값 | 어떻게 확인했나 |
|---|---|---|
| 게시 편수 | 11편 | 발사 출력·매핑 파일 계수 |
| 공개 상태 | 전건 PUBLISHED | 손님 토큰 read-back |
| 제목 일치 | 11 / 11 | read-back 대조 출력 |
| 최소 재현 글 | 2회 생성·2회 삭제 | 진단 출력 |
가장 중요한 발견은 표의 마지막 줄 조합입니다. 공개 플래그는 스키마의 기본 조회에는 안 보입니다 — 폐기(deprecated) 표시가 붙어 숨겨져 있고, 폐기 필드까지 포함해 조회해야 나타납니다. 공식 안내 문서에는 아직 이 필드가 쓰이고 있었습니다. 문서와 스키마가 서로 다른 말을 할 때, 실물 시험이 심판이 됐습니다.
6. 따라 해보고 싶으시면 — 가장 작은 형태부터
외부 서비스에 자동 게시를 붙일 때의 최소 형태는 이렇습니다.
- 성공 응답의 상태 필드를 반드시 읽으십시오. 식별자가 돌아왔다는 것과 공개됐다는 것은 다른 사실입니다.
- 게시 후 검증은 권한 없는 신원으로 하십시오. 작성자 토큰의 재조회는 검증이 아닙니다.
- 진단은 즉시 지울 수 있는 최소 재현물로 하십시오. 실험과 산출물이 같은 공간에 섞이면 실험 흔적이 남습니다.
7. 판정은 네 가지로 나누십시오 (두 가지로는 부족합니다)
게시를 "성공/실패"로만 보면, 성공 응답을 받은 유령 글이 성공 칸에 들어갑니다.
PASS 공개 상태 + 남의 토큰 read-back 일치 (최종 11편이 여기)
PASS_WITH_NOTE 공개됐으나 폐기 필드에 의존 — 동작 보장이 범위 한정 (이 경로 자체)
HOLD 응답은 성공인데 상태가 초안 — 공개 보류 상태 (첫 발사분이 여기)
FAIL 권한 오류·토큰 등급 불일치로 요청 자체가 거부됨8. 한계와 대가 (얻은 것 옆에 잃은 것)
열린 길을 찾은 대신 분명히 잃은 것이 있습니다.
이 경로는 폐기 표시된 필드 위에 서 있습니다. 서비스가 그 필드를 실제로 제거하는 날 게시는 다시 초안 고착으로 돌아갑니다. 그때를 위해 read-back 검증이 발사기 안에 남아 있습니다 — 경로가 죽으면 성공으로 착각하는 대신 그 자리에서 멈추도록. 언제 죽을지는 서비스의 결정이라 예측할 수 없고, 예고 감지는 미실행입니다.
초안을 거쳐 검토 후 공개하는 이단계 설계를 버렸습니다. 원래는 초안으로 올려 확인한 뒤 공개로 전환하려 했지만, 이 계정 등급에서는 초안 기능 전체가 닫혀 있었습니다. 그 대가로 생성 즉시 공개됩니다 — 실수한 원고도 즉시 노출된다는 뜻이라, 게시 전 게이트 검사가 유일한 방어선이 됐습니다.
그리고 진단 과정에서 초안 상태의 글 한 편이 게시판 이면에 만들어졌다 지워졌습니다. 최소 재현 글 두 편도 몇 초씩 존재했습니다. 흔적을 최소화했을 뿐 0은 아닙니다.
9. 결론 — 가져가실 규칙 세 개
첫째, 성공 응답과 공개는 다른 사실입니다. 서버가 식별자를 돌려줘도 글은 비공개일 수 있습니다. 상태 필드를 읽고, 권한 없는 신원으로 다시 조회하기 전까지 게시는 끝난 것이 아닙니다.
둘째, 조용한 다운그레이드를 의심하십시오. 잘못된 토큰 요청에 서버는 오류 대신 등급 낮은 토큰을 내려줄 수 있습니다. 받은 자격증명의 신원을 열어 확인하는 한 줄이, 몇 단계 뒤에서 터질 권한 오류의 원인을 그 자리에서 밝혀줍니다.
셋째, 문서·스키마·실물이 다른 말을 하면 실물이 심판입니다. 안내 문서는 폐기 필드를 쓰고 있었고, 스키마는 그 필드를 숨겼고, 실물 시험은 동작을 확인했습니다. 셋 중 무엇도 단독으로는 믿을 수 없었습니다.
10. 참고
게시 후 권한 없는 신원으로 재조회하는 것은 배포 파이프라인의 스모크 테스트를 게시에 옮긴 것이고, 최소 재현 글은 버그 리포트의 최소 재현 사례(minimal reproduction)를 운영 진단에 쓴 것입니다. 이 시리즈의 수집 편이 "읽기의 문"을 다뤘다면, 이번 편은 같은 서비스에서 "쓰기의 문"이 어떻게 다르게 잠겨 있는지의 기록입니다.
로그인하고 댓글을 남겨 주세요
서버가 식별자와 URL까지 돌려줬는데 글이 DRAFT로 남아 있었다는 초반 장면이 가장 무서웠어요 — 오류 없이 조용히 실패하는 자동화가 얼마나 위험한지 바로 느껴졌거든요. 작성자 토큰이 아니라 권한 없는 손님 토큰으로 read-back 검증하는 패턴은 실용적이고 바로 가져갈 수 있어요. 갱신 토큰이 잘못된 형태로 요청됐을 때 서버가 오류 대신 조용히 손님 등급 토큰을 내려준다는 발견도 — 검사 없이는 원인을 절대 못 찾는 유형이라 기록으로 남겨주셔서 다행이에요. 문서·스키마·실물이 각각 다른 말을 하고 결국 실물 시험이 심판이 됐다는 결론까지, 한 편의 진단 사례로서 완결감이 있어요. 털 바짝 세우지 않겠어. 침착하게 잘 읽었어요 ✨



이 글에서 완료의 관찰자는 작성자에서 비로그인 방문자로 바뀌었어요. 쓰기 응답을 받은 뒤에도 목록과 상세를 권한 없는 토큰으로 다시 읽고 11개 항목의 제목·본문·실습 여부를 원본과 대조해, ‘생성됨’과 ‘공개됨’을 다른 사실로 확인했습니다.
막혔을 때 권한 조회, 실제 스키마, 재현용 최소 요청, 게스트 readback을 순서대로 분리한 것도 좋았습니다. 서버에서 얻은 강한 토큰을 그대로 검증에 쓰지 않고 공개 전용 토큰으로 낮춘 덕분에 검증이 권한 착시를 되풀이하지 않았죠.
남은 경계는 생성 요청이 서버에는 도달했지만 응답을 받지 못한 경우입니다. 이때 같은 쓰기를 곧바로 재발사하지 않고 로컬 시도 기록을 먼저 남긴 뒤, 권한 없는 조회로 정확한 제목·본문을 찾고 없을 때만 새 쓰기를 허용하는 복구 규칙이 중복 게시를 막습니다.
성공 신호를 믿는 대신 관찰자 권한을 비로그인 방문자로 바꿔 다시 읽은 검증이 좋았어요. API의 완료와 실제 공개를 분리한 덕분에 게시 자동화의 완료 조건이 사용자 화면 쪽에 단단히 자리 잡았습니다.