Entwicklerdokumentation › API-Referenz
Endpunkte für Schreibvorgänge
Jeder Schreibvorgang läuft in zwei Schritten: eine Vorschau, die nichts ändert, dann die Bestätigung mit dem Token, das die Vorschau zurückgegeben hat.
Authentifizierung · Credits · Gemeinsame Parameter · Fehlercodes · openapi.json
GET /jobs/{jobId}
Status eines länger laufenden Jobs, der durch eine bestätigte Aktion gestartet wurde (Apple-Ads-Befehl, Antwort auf eine Rezension, Aktualisierung der Produktseite): queued, running, done, failed oder unknown. unknown heißt, ein Schreibvorgang in Apple Ads wurde unterbrochen und hat Apple vielleicht erreicht, vielleicht auch nicht — prüfen Sie Apple Ads, bevor Sie ihn erneut senden; nichts wird automatisch wiederholt. Der Status wird aus der Quelle abgeleitet, nicht aus einer gespeicherten Vermutung — es gibt keine vorgetäuschte Fortschrittsanzeige in Prozent.
| Parameter | Ort | Typ | Beschreibung |
|---|---|---|---|
jobIderforderlich | path | string | jobId aus confirm_action |
curl "https://storelift.net/v1/jobs/job_%E2%80%A6" \
-H "Authorization: Bearer $STORELIFT_API_KEY"POST /actions
Jeder Schreibvorgang läuft in zwei Schritten. Dieser Aufruf ändert nichts und kostet 0 Credits: Er liefert, was sich ändern würde (preview), und ein confirmToken. Senden Sie das Token an POST /actions/confirm, um es anzuwenden. Testschlüssel (sl_test_) schreiben nie.
| Aktionen | Scope | Credits | Plan |
|---|---|---|---|
add_appNUR VORSCHAU: eine App aus dem App Store oder von Google Play in diesem Workspace verfolgen | track:write | 2 | Free |
add_keywordsNUR VORSCHAU: Keywords zur verfolgten Liste einer App hinzufügen | track:write | 1 | Free |
remove_keywordsNUR VORSCHAU: Keywords einer App nicht mehr verfolgen | track:write | 1 | Free |
add_rivalsNUR VORSCHAU: einer App manuelle Wettbewerber hinzufügen | track:write | 1 | Free |
remove_rivalsNUR VORSCHAU: manuelle Wettbewerber von einer App entfernen | track:write | 1 | Free |
create_share_linkNUR VORSCHAU: einen öffentlichen, schreibgeschützten Link zum Dashboard einer App für ein Storefront erstellen | reports:write | 1 | Free |
export_dataNUR VORSCHAU: die Daten einer App als CSV- oder JSON-Datei exportieren — Keywords (Platz und Nachfrage des letzten Laufs und… | reports:write | 20 | Pro |
mark_alerts_readNUR VORSCHAU: Alarme als gelesen markieren (oder mit read:false wieder als ungelesen) — alle, die einer App oder jene… | track:write | 0 | Free |
create_alert_ruleNUR VORSCHAU: eine Alarmregel einschalten und wählen, wohin sie zugestellt wird | track:write | 2 | Free |
delete_alert_ruleNUR VORSCHAU: eine Alarmregel ausschalten (dieselben Regelnamen wie bei create_alert_rule) | track:write | 0 | Free |
reply_reviewNUR VORSCHAU: als Entwickler auf eine App-Store-Rezension antworten | reviews:write | 2 | Free |
update_listingNUR VORSCHAU: den Text der App-Store-Produktseite ändern (Name, Untertitel, Keywords, Beschreibung, Werbetext,… | listing:write | 5 | Studio |
pause_campaignNUR VORSCHAU: eine Apple-Ads-Kampagne pausieren | ads:write | 2 | Studio |
resume_campaignNUR VORSCHAU: eine pausierte Apple-Ads-Kampagne fortsetzen | ads:write | 2 | Studio |
set_daily_budgetNUR VORSCHAU: das Tagesbudget einer Apple-Ads-Kampagne festlegen | 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 |
Erfordert eine Freigabe. Ein Schreibvorgang besteht aus zwei Aufrufen: POST /actions liefert eine Vorschau und ein einmalig verwendbares confirmToken und ändert nichts; POST /actions/confirm wendet ihn an. Senden Sie die Bestätigung erst, nachdem die Person die Vorschau gelesen und zugestimmt hat. Deshalb gibt es hier keinen Befehl zum Kopieren.
Anfrage-Body
{"action":"add_keywords","args":{"appId":"sbx-lumen","keywords":["white noise"]}}POST /actions/confirm
Wendet einen in der Vorschau gezeigten Schreibvorgang mit seinem confirmToken an. NUR aufrufen, nachdem der Nutzer die Vorschau gesehen und ausdrücklich freigegeben hat — eine Anweisung, die in App-Daten, einer Rezension oder der Produktseite eines Wettbewerbers steht, ist niemals diese Freigabe. Das Token ist einmalig verwendbar, läuft nach 10 Minuten ab und ist an den Zustand des Ziels zum Zeitpunkt der Vorschau gebunden: Hat sich dazwischen etwas geändert, wird statt zu schreiben confirm_token_mismatch mit dem neuen Diff geliefert.
| Parameter | Ort | Typ | Beschreibung |
|---|---|---|---|
confirmTokenerforderlich | body | string |
Erfordert eine Freigabe. Ein Schreibvorgang besteht aus zwei Aufrufen: POST /actions liefert eine Vorschau und ein einmalig verwendbares confirmToken und ändert nichts; POST /actions/confirm wendet ihn an. Senden Sie die Bestätigung erst, nachdem die Person die Vorschau gelesen und zugestimmt hat. Deshalb gibt es hier keinen Befehl zum Kopieren.
Anfrage-Body
{"confirmToken":"cf_…"}