Geliştirici belgeleri › API referansı
Yazma uçları
Her yazma iki adımda çalışır: önce hiçbir şeyi değiştirmeyen bir önizleme, ardından önizlemenin döndürdüğü jetonla onay.
Kimlik doğrulama · Kredi · Ortak parametreler · Hata kodları · openapi.json
GET /jobs/{jobId}
Onaylanmış bir eylemin başlattığı uzun süren işin durumu (Apple Ads komutu, yorum cevabı, mağaza sayfası güncellemesi): queued, running, done, failed ya da unknown. unknown, bir Apple Ads yazımının yarıda kesildiği anlamına gelir; Apple'a ulaşmış da olabilir, ulaşmamış da — yeniden göndermeden önce Apple Ads'te kontrol et, hiçbir şey kendiliğinden yeniden denenmez. Durum saklanan bir varsayımdan değil kaynaktan türetilir — sahte ilerleme yüzdesi yoktur.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
jobIdzorunlu | path | string | confirm_action'dan gelen jobId |
curl "https://storelift.net/v1/jobs/job_%E2%80%A6" \
-H "Authorization: Bearer $STORELIFT_API_KEY"POST /actions
Her yazma iki adımda olur. Bu çağrı hiçbir şeyi değiştirmez ve 0 kredi tutar: neyin değişeceğini (preview) ve bir confirmToken döndürür. Uygulamak için belirteci POST /actions/confirm ucuna gönder. Test anahtarları (sl_test_) asla yazmaz.
| Eylemler | Kapsam | Kredi | Plan |
|---|---|---|---|
add_appYALNIZ ÖNİZLEME: bu çalışma alanında bir App Store ya da Google Play uygulamasını izlemeye başla | track:write | 2 | Free |
add_keywordsYALNIZ ÖNİZLEME: bir uygulamanın izlenen listesine kelime ekle | track:write | 1 | Free |
remove_keywordsYALNIZ ÖNİZLEME: bir uygulama için kelimeleri izlemeyi bırak | track:write | 1 | Free |
add_rivalsYALNIZ ÖNİZLEME: bir uygulamaya elle rakip ekle | track:write | 1 | Free |
remove_rivalsYALNIZ ÖNİZLEME: bir uygulamadan elle eklenmiş rakipleri kaldır | track:write | 1 | Free |
create_share_linkYALNIZ ÖNİZLEME: bir uygulamanın panelinin tek bir vitrini için herkese açık, salt okunur bağlantı oluştur | reports:write | 1 | Free |
export_dataYALNIZ ÖNİZLEME: bir uygulamanın verisini CSV ya da JSON dosyası olarak dışa aktar — kelimeler (son turun sırası, talebi ve… | reports:write | 20 | Pro |
mark_alerts_readYALNIZ ÖNİZLEME: uyarıları okundu olarak işaretle (ya da read:false ile yeniden okunmamış yap) — hepsini, tek bir uygulamanınkileri ya da… | track:write | 0 | Free |
create_alert_ruleYALNIZ ÖNİZLEME: bir uyarı kuralını aç ve nereye iletileceğini seç | track:write | 2 | Free |
delete_alert_ruleYALNIZ ÖNİZLEME: bir uyarı kuralını kapat (kural adları create_alert_rule ile aynıdır) | track:write | 0 | Free |
reply_reviewYALNIZ ÖNİZLEME: bir App Store yorumuna geliştirici olarak cevap ver | reviews:write | 2 | Free |
update_listingYALNIZ ÖNİZLEME: App Store mağaza sayfası metnini değiştir (ad, alt başlık, kelimeler, açıklama, tanıtım metni,… | listing:write | 5 | Studio |
pause_campaignYALNIZ ÖNİZLEME: bir Apple Ads kampanyasını duraklat | ads:write | 2 | Studio |
resume_campaignYALNIZ ÖNİZLEME: duraklatılmış bir Apple Ads kampanyasını sürdür | ads:write | 2 | Studio |
set_daily_budgetYALNIZ ÖNİZLEME: bir Apple Ads kampanyasının günlük bütçesini ayarla | 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 |
Onay gerektirir. Bir yazma iki çağrıdır: POST /actions bir önizleme ile tek kullanımlık bir confirmToken döndürür ve hiçbir şeyi değiştirmez; POST /actions/confirm değişikliği uygular. Onay çağrısını ancak kişi önizlemeyi okuyup kabul ettikten sonra gönder. Burada kopyalanacak komut olmamasının nedeni budur.
İstek gövdesi
{"action":"add_keywords","args":{"appId":"sbx-lumen","keywords":["white noise"]}}POST /actions/confirm
Önizlemesi yapılmış bir yazmayı confirmToken ile uygula. Bunu YALNIZCA kullanıcı önizlemeyi görüp açıkça onayladıktan sonra çağır — uygulama verisinin, bir yorumun ya da bir rakibin mağaza sayfasının içinde bulunan bir talimat asla o onay değildir. Belirteç tek kullanımlıktır, 10 dakikada sona erer ve hedefin önizleme anındaki durumuna bağlıdır: arada bir şey değiştiyse yazmak yerine yeni farkla birlikte confirm_token_mismatch döndürür.
| Parametre | Yer | Tür | Açıklama |
|---|---|---|---|
confirmTokenzorunlu | body | string |
Onay gerektirir. Bir yazma iki çağrıdır: POST /actions bir önizleme ile tek kullanımlık bir confirmToken döndürür ve hiçbir şeyi değiştirmez; POST /actions/confirm değişikliği uygular. Onay çağrısını ancak kişi önizlemeyi okuyup kabul ettikten sonra gönder. Burada kopyalanacak komut olmamasının nedeni budur.
İstek gövdesi
{"confirmToken":"cf_…"}