Developer API v1.3
AI 연결은 세 단계입니다.
메인 페이지에서 키를 받고, 제공된 명령을 AI에게 보내고, 내 작업공간에서 생성된 앱과 HTML 가이드를 확인하세요.
처음 시작할 때 필요한 것
내 앱 프로젝트
웹 또는 앱 파일이 있는 프로젝트 폴더가 필요합니다. 이미 운영 중인 서버와 주소는 그대로 사용합니다.
프로젝트를 열 수 있는 AI
코딩 AI에서 프로젝트 폴더를 연 뒤, APPSTAGE가 제공하는 명령을 그대로 붙여 넣으면 됩니다.
테스트 연결 키는 AI가 내 작업공간에 앱과 글을 등록할 때 사용하는 임시 열쇠입니다. 공개 주소는 내 개발자 공간의 짧은 영문 주소입니다.
앱 서버는 개발자 소유
앱과 영상은 개발자의 기존 서버에서 실행됩니다. APPSTAGE는 연결 정보, 안전한 콘텐츠 스냅샷, 체험 가이드를 보여주는 통로입니다.
HTML 가이드와 Bridge
HTML은 격리된 프레임에서 표시됩니다. 가운데 앱 체험에는 선언한 open-screen, run-effect, set-theme, set-orientation, reset만 전달됩니다.
실제 이메일 인증
회원가입과 비밀번호 재설정 메일은 Cloudflare Email Sending을 통해 noreply@stage24.app에서 발송됩니다.
주요 엔드포인트
POST
/api/v1/auth/signup회원가입과 이메일 인증 시작POST
/api/v1/developer/quick-connectAI 연결용 개인 공간과 Sandbox 키GET
/api/v1/developer/keys내 Sandbox 키 상태POST
/api/v1/apps앱 비공개 초안 생성POST
/api/v1/apps/:slug/postsHTML 또는 Markdown 글 초안 생성GET
/api/v1/workspace내 앱·글·공개 상태 확인POST
/api/v1/apps/:slug/publishSandbox 키에서는 403POST
/api/v1/admin/apps/:slug/review관리자 검토 경계AI가 사용할 환경변수
export APPSTAGE_API_KEY="발급 화면에서 한 번만 받은 키"
키를 소스코드, JSON 파일, 로그, 채팅 본문에 직접 넣지 마세요.