upload-assets

이 스킬의 경계

바이트를 올리는 것        당신
검토 요청 버튼을 누르는 것  사람

image_upload_url + PUT 은 CDN 에 파일을 올릴 뿐 아무것도 신청하지 않는다. 여기까지는 당신이 한다. 반면 miniapp_update_icon 과 miniapp_update_screenshots 는 이름과 달리 앱정보 검토를 함께 신청한다. 콘솔 웹의 "검토 요청" 버튼과 같다 — 부르지 마라.

코어 하드 룰 2번이다. 출고 버튼은 사람이 누른다.

올리기 전에

pnpm assets

규격 통과 가 아니면 올리지 마라. 해상도가 어긋난 파일은 업로드 자체는 되지만 (발급 단계는 확장자와 크기만 본다) 그 URL 을 쓰는 순간 거부된다.

올리는 절차

파일 하나마다 세 단계다. 순서를 바꾸면 실패한다.

1. 크기를 정확히 재고 발급받는다

image_upload_url(workspaceId, extension, contentLength)
  → uploadUrl · publicUrl · contentType

contentLength 는 실제 byte 수여야 한다. 어림수를 넣으면 PUT 이 거부된다. uploadUrl 은 10분간 유효하다. 만료되면 다시 발급받는다.

2. PUT 으로 올린다

curl -X PUT \
  -H 'Content-Type: {contentType}' \
  -H 'x-amz-acl: public-read' \
  --data-binary @{파일경로} \
  '{uploadUrl}'

인증 헤더는 필요 없다. 두 헤더와 Content-Length 가 발급 조건과 다르면 거부된다. 완료 통지 도구는 없다 — PUT 이 성공하면 그것이 완료다.

3. publicUrl 을 기록한다

release/ 에 남긴다. 로컬 경로나 이 절차로 발급되지 않은 외부 URL 은 콘솔이 거부한다.

그다음 — 페이로드를 만들어 사람에게 넘긴다

miniapp_update_* 는 전체 페이로드를 다시 보내는 방식이다. 안 바꿀 값도 다 담아야 하고, 빠뜨리면 기존 값이 사라진다. 그러니 당신이 만들어 두고 사람이 누르게 한다.

miniapp_get 으로 지금 값을 가져와 그대로 옮긴다. 카테고리는 모양이 다르니 주의:

조회 (miniapp_get)	요청
impression.categoryPaths[].category.id	impression.categoryIds
impression.categoryPaths[].subCategory.id	impression.subCategoryIds
impression.keywordList	impression.keywordList (그대로)

옮기지 않으면 기존 카테고리와 검색 키워드가 지워진다.

썸네일은 images[] 의 imageType=THUMBNAIL · orientation=HORIZONTAL 에 넣는다. 여기를 비우면 AI 자동 검수에서 썸네일 항목이 통째로 빠진다.

사람에게 넘길 때 반드시 보여줄 것

콘솔은 아래 5개에 모두 동의해야 검토 요청 버튼이 열린다. 당신이 대신 동의할 수 없다. 원문 그대로 보여주고 확인을 받아라.

1. 앱인토스에서 오픈할 수 있는 서비스다
2. 환전·현금화·자금세탁 우려가 있는 서비스가 아니다
3. 서비스 운영에 필요한 인허가·등록·신고를 모두 마쳤다
4. 부정행위를 조장하거나 신분증 위조 등 위법 행위를 포함하지 않는다
5. 위반으로 문제가 생기면 모든 책임은 파트너사에 있고 토스에 생긴 손해를 보상한다

부르지 않는 도구

도구	왜
miniapp_update_icon · miniapp_update_screenshots	검토 요청이 함께 나간다
miniapp_update_basic_info · miniapp_update_category	같은 이유
review_submit · review_cancel	검수 신청은 사람의 행위

출력

• 올린 파일과 publicUrl 목록
• 조립한 페이로드 (JSON, release/ 에 저장)
• 위 5개 확약 문구
• 다음 행동: "콘솔에서 검토 요청 버튼을 누르세요"