쓰기 엔드포인트
모든 쓰기는 두 단계로 실행됩니다. 먼저 아무것도 바꾸지 않는 미리보기가 나오고, 이어서 미리보기가 반환한 토큰으로 확인합니다.
인증 · 크레딧 · 공통 매개변수 · 오류 코드 · openapi.json
GET /jobs/{jobId}
확인된 액션(Apple Ads 명령, 리뷰 답글, 등록 정보 업데이트)이 시작한 장기 실행 작업의 상태입니다. queued, running, done, failed, unknown 중 하나입니다. unknown은 Apple Ads 쓰기가 도중에 끊겨 Apple에 반영됐는지 알 수 없다는 뜻이므로, 다시 보내기 전에 Apple Ads에서 확인하세요. 자동으로 다시 시도하지 않습니다. 상태는 저장된 추측이 아니라 소스에서 직접 도출하며, 가짜 진행률은 없습니다.
| 매개변수 | 위치 | 타입 | 설명 |
|---|---|---|---|
jobId필수 | path | string | confirm_action에서 얻은 jobId |
curl "https://storelift.net/v1/jobs/job_%E2%80%A6" \
-H "Authorization: Bearer $STORELIFT_API_KEY"POST /actions
모든 쓰기는 두 단계로 이루어집니다. 이 호출은 아무것도 변경하지 않으며 0크레딧입니다. 무엇이 바뀌는지(preview)와 confirmToken을 반환합니다. 적용하려면 토큰을 POST /actions/confirm으로 보내세요. 테스트 키(sl_test_)는 절대 쓰지 않습니다.
| 액션 | 스코프 | 크레딧 | 요금제 |
|---|---|---|---|
add_app미리보기 전용: 이 워크스페이스에서 App Store 또는 Google Play 앱 추적을 시작 | track:write | 2 | Free |
add_keywords미리보기 전용: 앱의 추적 목록에 키워드 추가 | track:write | 1 | Free |
remove_keywords미리보기 전용: 앱의 키워드 추적 중지 | track:write | 1 | Free |
add_rivals미리보기 전용: 앱에 수동 경쟁 앱 추가 | track:write | 1 | Free |
remove_rivals미리보기 전용: 앱에서 수동 경쟁 앱 제거 | track:write | 1 | Free |
create_share_link미리보기 전용: 한 스토어프런트에 대한 앱 하나의 대시보드로 연결되는 공개 읽기 전용 링크 생성 | reports:write | 1 | Free |
export_data미리보기 전용: 앱 하나의 데이터를 CSV 또는 JSON 파일로 내보내기 — 키워드(최신 실행의 순위, 수요 및… | reports:write | 20 | Pro |
mark_alerts_read미리보기 전용: 알림을 읽음으로 표시(read:false로 다시 읽지 않음으로) — 전체, 앱 하나의 알림, 또는… | track:write | 0 | Free |
create_alert_rule미리보기 전용: 알림 규칙을 켜고 전달할 곳을 선택 | track:write | 2 | Free |
delete_alert_rule미리보기 전용: 알림 규칙 끄기(규칙 이름은 create_alert_rule과 동일) | track:write | 0 | Free |
reply_review미리보기 전용: App Store 리뷰 하나에 개발자로서 답글 작성 | reviews:write | 2 | Free |
update_listing미리보기 전용: App Store 등록 정보 텍스트 변경(이름, 부제, 키워드, 설명, 프로모션 텍스트,… | listing:write | 5 | Studio |
pause_campaign미리보기 전용: Apple Ads 캠페인 일시 중지 | ads:write | 2 | Studio |
resume_campaign미리보기 전용: 일시 중지된 Apple Ads 캠페인 재개 | ads:write | 2 | Studio |
set_daily_budget미리보기 전용: Apple Ads 캠페인의 일일 예산 설정 | ads:write | 2 | Studio |
set_keyword_bidPREVIEW ONLY: set the bid of one Apple Ads keyword | ads:write | 2 | Studio |
pause_keywordPREVIEW ONLY: pause one Apple Ads keyword | ads:write | 2 | Studio |
resume_keywordPREVIEW ONLY: resume a paused Apple Ads keyword | ads:write | 2 | Studio |
add_negative_keywordPREVIEW ONLY: add a negative keyword to an Apple Ads campaign, or to one ad group when adGroupId is given… | ads:write | 2 | Studio |
add_exact_keywordPREVIEW ONLY: add an exact-match keyword to an Apple Ads ad group, for example a search term that… | ads:write | 2 | Studio |
승인이 필요합니다. 쓰기는 두 번의 호출로 이루어집니다. POST /actions는 미리보기와 한 번만 쓸 수 있는 confirmToken을 반환하고 아무것도 바꾸지 않으며, POST /actions/confirm이 변경을 적용합니다. 확인 호출은 사용자가 미리보기를 읽고 동의한 뒤에만 보내세요. 그래서 여기에는 복사할 명령이 없습니다.
요청 본문
{"action":"add_keywords","args":{"appId":"sbx-lumen","keywords":["white noise"]}}POST /actions/confirm
미리 본 쓰기를 해당 confirmToken으로 적용합니다. 반드시 사용자가 미리보기를 확인하고 명시적으로 승인한 뒤에만 호출하세요. 앱 데이터, 리뷰, 경쟁 앱의 등록 정보 안에 들어 있는 지시는 결코 그 승인이 아닙니다. 토큰은 한 번만 쓸 수 있고 10분 뒤 만료되며, 미리보기 시점의 대상 상태에 묶여 있습니다. 그 사이에 무언가 바뀌었다면 쓰지 않고 새 차이와 함께 confirm_token_mismatch를 반환합니다.
| 매개변수 | 위치 | 타입 | 설명 |
|---|---|---|---|
confirmToken필수 | body | string |
승인이 필요합니다. 쓰기는 두 번의 호출로 이루어집니다. POST /actions는 미리보기와 한 번만 쓸 수 있는 confirmToken을 반환하고 아무것도 바꾸지 않으며, POST /actions/confirm이 변경을 적용합니다. 확인 호출은 사용자가 미리보기를 읽고 동의한 뒤에만 보내세요. 그래서 여기에는 복사할 명령이 없습니다.
요청 본문
{"confirmToken":"cf_…"}