Документация для разработчиков › Справочник API
Эндпоинты записи
Каждая запись идёт в два шага: предпросмотр, который ничего не меняет, затем подтверждение с токеном, который он вернул.
Аутентификация · Кредиты · Общие параметры · Коды ошибок · openapi.json
GET /jobs/{jobId}
Статус длительного задания, запущенного подтверждённым действием (команда Apple Ads, ответ на отзыв, обновление страницы): queued, running, done, failed или unknown. unknown означает, что запись в Apple Ads прервалась и могла дойти до Apple, а могла и нет: проверьте в Apple Ads, прежде чем отправлять снова; автоматического повтора нет. Статус берётся из источника, а не из сохранённого предположения: фиктивного процента выполнения нет.
| Параметр | Где | Тип | Описание |
|---|---|---|---|
jobIdобязательный | path | string | jobId из confirm_action |
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 с новым diff.
| Параметр | Где | Тип | Описание |
|---|---|---|---|
confirmTokenобязательный | body | string |
Нужно одобрение. Запись — это два вызова: POST /actions возвращает предпросмотр и одноразовый confirmToken и ничего не меняет; POST /actions/confirm применяет изменение. Отправляйте подтверждение, только когда человек прочитал предпросмотр и согласился. Поэтому команды для копирования здесь нет.
Тело запроса
{"confirmToken":"cf_…"}