메인 콘텐츠로 건너뛰기

이 프롬프트를 복사하세요

복사해서 에이전트에 붙여넣고, <...> 자리만 채우세요 — 서비스, 스택, 실제 작업 내용입니다. 나머지는 그대로 두시면 됩니다. 프롬프트는 의도적으로 짧습니다. API를 다시 옮겨 적는 대신, 에이전트가 스스로는 하지 않는 세 가지만 시킵니다. 코드를 쓰기 전에 문서를 읽고 위험한 부분을 보고하게 하고, 출시하면 안 되는 실수를 못박고(confirm 단계 누락, 웹훅 서명 미검증, API 키 하드코딩), 마지막에 연동이 실제로 동작함을 증명하게 합니다 — 동작한다고 주장만 하지 않도록.
프롬프트 본문은 의도적으로 영어로 작성되어 있습니다. 코딩 에이전트는 영어 지시문에서 가장 안정적으로 동작하며, 엔드포인트·필드명과 표기를 일치시키기 위해서입니다. 상단 My task 항목에는 한국어로 작업을 적어도 문제없이 동작합니다.

에디터에서 사용하기

일회성 작업이라면 세션에 그대로 붙여넣으면 됩니다.모든 세션에서 자동으로 불러오려면 프롬프트를 .claude/bizmori-api.md로 저장하고 CLAUDE.md에서 import 하세요:
CLAUDE.md
Claude Code는 시작 시 import된 파일을 읽으므로, 요청하기 전에 이미 지시문이 컨텍스트에 들어옵니다.

에이전트에 실시간 문서 연결하기

위 프롬프트가 짧아도 되는 이유가 여기 있습니다. 이 문서는 기계가 읽을 수 있는 형식으로도 제공되므로, 에이전트는 프롬프트가 작성된 시점의 내용이 아니라 요청하는 그 순간의 최신 스펙을 직접 가져옵니다.
둘 다 필요하며 서로를 대체하지 않습니다. llms-full.txt에는 가이드는 담기지만 필드 정의는 담기지 않습니다 — 파라미터 표는 OpenAPI 스펙에서 렌더되는 것이라 평문으로 옮겨지지 않기 때문입니다. llms-full.txt만 받은 에이전트는 코드 샘플을 보고 요청 바디를 역추정하고 나머지는 추측하게 됩니다. 프롬프트가 두 파일을 모두 가져오게 하는 이유입니다.

배포 전 확인할 것

배포 전 아래 네 가지는 반드시 확인하세요. 가장 자주 발생하는 실수입니다.
키는 반드시 환경 변수나 시크릿 매니저에서 읽어야 하며, 소스 코드에 있어서는 안 됩니다. 변경분에서 Bearer 및 키처럼 보이는 리터럴을 검색하고, 키가 로그에 남지 않는지 확인하세요.
Anti-AI(업로드 모드)와 AI Detection은 confirm 호출이 필요합니다. Watermark Embed와 Watermark Extract는 필요 없으며, 호출하면 실패합니다. Anti-AI를 URL 모드로만 쓰는 경우에도 confirm은 호출하지 않습니다.
HMAC은 원본 요청 바이트(raw body)로 계산해야 합니다. JSON 파서가 먼저 실행된 뒤 객체를 다시 직렬화하면 서명이 맞지 않으며, 이때 에이전트가 검증을 건너뛰는 방식으로 “고치려” 들 수 있습니다. 비교는 반드시 상수 시간(constant-time)으로 해야 합니다.
업로드·다운로드 URL은 1시간 동안만 유효합니다. 오래 걸리는 배치 작업이라면 만료된 URL을 재사용하지 말고 URL 재발급 엔드포인트를 호출해야 합니다.

다음 단계

퀵스타트

자동화하기 전에 직접 한 번 흐름을 따라가 보세요.

API 레퍼런스

모든 엔드포인트의 기준 스펙입니다.

웹훅

서명 검증과 이벤트 페이로드 전체 설명입니다.

에러 코드

에이전트의 에러 처리가 다뤄야 할 모든 코드입니다.