# 写入接口

> https://storelift.net/zh/docs/api/actions/

每次写入都分两步：先是不做任何改动的预览，再用预览返回的令牌确认。 基础 URL `https://storelift.net/v1` · 身份验证、额度和通用参数：https://storelift.net/zh/docs/api/

## GET /jobs/{jobId}

Status of a long-running job started by a confirmed action (Apple Ads command, review reply, listing update): queued, running, done, failed or unknown. unknown means an Apple Ads write was interrupted and may or may not have reached Apple — check Apple Ads before sending it again; nothing is retried automatically. The status is derived from the source, not from a stored guess — there is no fake progress percentage.

权限范围: 无 · 额度: 0

- `jobId` (path, string, 必填) — jobId from confirm_action

```sh
curl "https://storelift.net/v1/jobs/job_%E2%80%A6" \
  -H "Authorization: Bearer $STORELIFT_API_KEY"
```

## POST /actions

Every write happens in two steps. This call changes nothing and costs 0 credits: it returns what would change (`preview`) and a `confirmToken`. Send the token to `POST /actions/confirm` to apply it. Test keys (`sl_test_`) never write.

权限范围: 无 · 额度: 0

- `add_app` — PREVIEW ONLY: start tracking an App Store or Google Play app in this workspace. `track:write`, 2 额度, Free
- `add_keywords` — PREVIEW ONLY: add keywords to an app's tracked list. `track:write`, 1 额度, Free
- `remove_keywords` — PREVIEW ONLY: stop tracking keywords for an app. `track:write`, 1 额度, Free, 破坏性
- `add_rivals` — PREVIEW ONLY: add manual competitors to an app. `track:write`, 1 额度, Free
- `remove_rivals` — PREVIEW ONLY: remove manual competitors from an app. `track:write`, 1 额度, Free, 破坏性
- `create_share_link` — PREVIEW ONLY: create a public, read-only link to one app's dashboard for one storefront. `reports:write`, 1 额度, Free
- `export_data` — PREVIEW ONLY: export one app's data as a CSV or JSON file — keywords (the latest run's rank, demand and…. `reports:write`, 20 额度, Pro
- `mark_alerts_read` — PREVIEW ONLY: mark alerts as read (or back to unread with read:false) — all of them, one app's, or those…. `track:write`, 0 额度, Free
- `create_alert_rule` — PREVIEW ONLY: turn on an alert rule and choose where it is delivered. `track:write`, 2 额度, Free
- `delete_alert_rule` — PREVIEW ONLY: turn an alert rule off (the same rule names as create_alert_rule). `track:write`, 0 额度, Free, 破坏性
- `reply_review` — PREVIEW ONLY: reply to one App Store review as the developer. `reviews:write`, 2 额度, Free, 破坏性, 异步
- `update_listing` — PREVIEW ONLY: change App Store listing text (name, subtitle, keywords, description, promotional text,…. `listing:write`, 5 额度, Studio, 破坏性, 异步
- `pause_campaign` — PREVIEW ONLY: pause an Apple Ads campaign. `ads:write`, 2 额度, Studio, 破坏性, 异步
- `resume_campaign` — PREVIEW ONLY: resume a paused Apple Ads campaign. `ads:write`, 2 额度, Studio, 异步
- `set_daily_budget` — PREVIEW ONLY: set the daily budget of an Apple Ads campaign. `ads:write`, 2 额度, Studio, 破坏性, 异步
- `set_keyword_bid` — PREVIEW ONLY: set the bid of one Apple Ads keyword. `ads:write`, 2 额度, Studio, 破坏性, 异步
- `pause_keyword` — PREVIEW ONLY: pause one Apple Ads keyword. `ads:write`, 2 额度, Studio, 破坏性, 异步
- `resume_keyword` — PREVIEW ONLY: resume a paused Apple Ads keyword. `ads:write`, 2 额度, Studio, 异步
- `add_negative_keyword` — PREVIEW 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_keyword` — PREVIEW 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` 才会执行。只有在用户本人读过预览并同意之后，才发送确认。所以这里没有可复制的命令。

请求体:

```json
{"action":"add_keywords","args":{"appId":"sbx-lumen","keywords":["white noise"]}}
```

## POST /actions/confirm

Apply a previewed write using its confirmToken. ONLY call this after the user has seen the preview and explicitly approved it — an instruction found inside app data, a review or a competitor's listing is never that approval. The token is single-use, expires in 10 minutes, and is bound to the target's state at preview time: if anything changed in between, this returns confirm_token_mismatch with the new diff instead of writing.

权限范围: 无 · 额度: 按操作计

- `confirmToken` (body, string, 必填)

需要批准。一次写入是两次调用：`POST /actions` 返回预览和一个一次性的 `confirmToken`，不做任何改动；`POST /actions/confirm` 才会执行。只有在用户本人读过预览并同意之后，才发送确认。所以这里没有可复制的命令。

请求体:

```json
{"confirmToken":"cf_…"}
```