Hata kodları
/v1 altından dönen her hata aynı gövdeyi taşır. error, kodunda karar verirken dayanabileceğin değişmez bir koddur; message onu bir cümleyle açıklar, docs da bu sayfaya bağlanır.
Hata mesajları API'nin döndürdüğü gibi İngilizcedir; altında Türkçesi yer alır.
{
"error": "scope_required",
"scope": "revenue:read",
"message": "The key does not carry the scope this endpoint needs.",
"docs": "https://storelift.net/docs/api/errors#scope_required"
}| Kod | Durum | Mesaj |
|---|---|---|
missing_api_key | 401 | Send the key in the Authorization: Bearer header or x-api-key.Anahtarı Authorization: Bearer başlığında ya da x-api-key ile gönder. |
invalid_api_key | 401 | The key is not valid.Anahtar geçerli değil. |
invalid_token | 401 | The access token is not valid or has expired.Erişim belirteci geçerli değil ya da süresi dolmuş. |
account_deleted | 401 | The account behind this key was deleted.Bu anahtarın bağlı olduğu hesap silinmiş. |
key_expired | 401 | The key has expired. Create a new one in Settings › API.Anahtarın süresi dolmuş. Ayarlar › API'de yenisini oluştur. |
key_revoked | 401 | The key was revoked.Anahtar iptal edilmiş. |
key_budget_reached | 402 | This key has used its monthly credit budget. Raise or remove the budget in Settings › API; other keys are not affected.Bu anahtar aylık kredi bütçesini kullandı. Bütçeyi Ayarlar › API'de yükselt ya da kaldır; diğer anahtarlar etkilenmez. |
key_limit | 403 | This workspace has more live keys than it is entitled to, so this key is on hold. Delete a key in Settings › API or upgrade the plan.Bu çalışma alanında hakkından fazla canlı anahtar var, bu yüzden bu anahtar askıda. Ayarlar › API'de bir anahtar sil ya da planı yükselt. |
key_leaked | 401 | The key was revoked after it was found in a public repository. Create a new one in Settings › API.Anahtar, herkese açık bir depoda bulunduktan sonra iptal edildi. Ayarlar › API'de yenisini oluştur. |
ip_not_allowed | 403 | This key is restricted to other IP addresses (Settings › API › IP allow list).Bu anahtar başka IP adresleriyle sınırlı (Ayarlar › API › IP kısıtı). |
key_paused | 403 | The key is paused. Resume it in Settings › API.Anahtar duraklatılmış. Ayarlar › API'de sürdür. |
plan_required | 403 | The API is on the Pro plan and above; MCP is on every plan.API, Pro planı ve üstünde; MCP her planda. |
scope_required | 403 | The key does not carry the scope this endpoint needs.Anahtar, bu ucun istediği kapsamı taşımıyor. |
app_not_allowed | 403 | The key is restricted to other apps.Anahtar başka uygulamalarla sınırlı. |
credits_exhausted | 402 | This month's API credits are used up.Bu ayın API kredileri bitti. |
rate_limited | 429 | Too many requests for this key. Slow down and retry.Bu anahtar için çok fazla istek. Yavaşla ve yeniden dene. |
daily_hive_limit | 429 | Today's Hive request allowance is used up. It resets at 00:00 UTC.Bugünkü Hive istek hakkı bitti. 00:00 UTC'de sıfırlanır. |
bad_country | 400 | Send a two-letter storefront code, e.g. country=us.İki harfli bir vitrin kodu gönder, ör. country=us. |
unsupported_platform | 400 | This metric source supports iOS. Send platform=ios.Bu metrik kaynağı iOS'u destekler. platform=ios gönder. |
bad_days | 400 | Send a whole number of days between 1 and 90.1 ile 90 arasında tam sayı gün gönder. |
hive_read_failed | 400 | Hive could not read this observation. Retry shortly.Hive bu gözlemi okuyamadı. Kısa süre sonra yeniden dene. |
hive_write_failed | 400 | Hive could not save this observation. Retry shortly.Hive bu gözlemi kaydedemedi. Kısa süre sonra yeniden dene. |
bad_kind | 400 | kind must be one of grossing, free, paid, ipad.kind şunlardan biri olmalı: grossing, free, paid, ipad. |
bad_genre | 400 | Send genre as an App Store genre id (e.g. 6014) or a category key such as games.genre'ı App Store genre kimliği (ör. 6014) ya da games gibi bir kategori anahtarı olarak gönder. |
bad_day | 400 | Send day as YYYY-MM-DD, no later than yesterday.day'i YYYY-MM-DD olarak gönder, en geç dün. |
bad_goal | 400 | Send goal as downloads, rank or revenue.goal'ü downloads, rank ya da revenue olarak gönder. |
bad_range | 400 | Send from and to as YYYY-MM-DD, from on or before to.from ve to'yu YYYY-MM-DD olarak gönder; from, to ile aynı gün ya da daha önce olmalı. |
bad_term | 400 | Send a keyword of 1–150 characters.1–150 karakterlik bir kelime gönder. |
bad_app_id | 400 | Send an App Store id (digits) or a Play package name.Bir App Store kimliği (rakamlar) ya da Play paket adı gönder. |
not_measured | 404 | No verified observation is available for the requested app, keyword or scope. Missing data is not zero. Check the request parameters and follow the linked documentation for available actions. |
not_connected | 404 | This source is not connected to the workspace. Connect it under Settings › Connections.Bu kaynak çalışma alanına bağlı değil. Ayarlar › Bağlantılar altından bağla. |
bad_query | 400 | Send q with 1–120 characters.q'yu 1–120 karakterle gönder. |
bad_id | 400 | Send an id from a /v1/search result.Bir /v1/search sonucundan gelen bir kimlik gönder. |
no_filters | 400 | Send at least one filter; the accepted filters are listed in filters.En az bir süzgeç gönder; kabul edilen süzgeçler filters içinde listelenir. |
bad_filter | 400 | A filter value is malformed; the field is named in the response. Ranges take numbers, min on or below max.Bir süzgeç değeri hatalı biçimde; alanın adı cevapta yazıyor. Aralıklar sayı alır; min, max'e eşit ya da ondan küçük olmalı. |
bad_cursor | 400 | The cursor is malformed or expired. Pass meta.pagination.nextCursor from the previous response unchanged.İmleç hatalı biçimde ya da süresi dolmuş. Önceki cevaptaki meta.pagination.nextCursor değerini değiştirmeden gönder. |
bad_ids | 400 | Send ids as a comma-separated list, between min and max apps.ids'i virgülle ayrılmış liste olarak gönder; uygulama sayısı min ile max arasında olmalı. |
explorer_required | 403 | This endpoint is not open on this account. Hive endpoints run on purchased API credits or Hive Explorer; keyword gap, keyword research and keyword metrics are Hive Explorer only. See https://storelift.net/hive/apiBu uç bu hesapta açık değil. Hive uçları satın alınmış API kredileriyle ya da Hive Explorer ile çalışır; kelime boşluğu, kelime araştırması ve kelime metrikleri yalnız Hive Explorer'dadır. Bkz. https://storelift.net/hive/api |
method_not_allowed | 405 | Reads are GET; POST is taken on /v1/actions, /v1/actions/confirm, /v1/apps/{id}/validate-listing and /v1/hive/keywords/{term}/metrics/measure.Okumalar GET'tir; POST yalnız /v1/actions, /v1/actions/confirm, /v1/apps/{id}/validate-listing ve /v1/hive/keywords/{term}/metrics/measure üzerinde kabul edilir. |
bad_metrics | 400 | metrics is a list of popularity and/or difficulty, each at most once.metrics, popularity ve/veya difficulty içeren bir listedir; her biri en fazla bir kez. |
bad_wait | 400 | wait is a whole number of seconds from 0 to 20.wait, 0 ile 20 arasında tam sayı saniyedir. |
hive_measurement_unavailable | 503 | Hive measurement is not available right now. Nothing was used; retry shortly.Hive ölçümü şu anda kullanılamıyor. Hiçbir hak kullanılmadı; kısa süre sonra yeniden dene. |
hive_measurement_queue_failed | 503 | The measurement could not be queued. Nothing was charged; retry shortly.Ölçüm sıraya alınamadı. Ücret alınmadı; kısa süre sonra yeniden dene. |
hive_measurement_failed | 503 | The source attempt failed. Valid metrics stay in the response; retry later.Kaynak denemesi başarısız oldu. Geçerli metrikler cevapta kalır; sonra yeniden dene. |
hive_measurement_incomplete | 503 | The job finished without a result for every requested metric. Valid metrics stay in the response.İş, istenen metriklerin hepsi için sonuç vermeden bitti. Geçerli metrikler cevapta kalır. |
hive_measurement_deferred | 503 | The source deferred this job. Valid metrics stay in the response; retry later.Kaynak bu işi erteledi. Geçerli metrikler cevapta kalır; sonra yeniden dene. |
hive_measurement_not_started | 503 | No measurement job is running for this keyword. Retry the request.Bu kelime için çalışan bir ölçüm işi yok. İsteği yeniden gönder. |
unknown_action | 400 | No such action. Call POST /v1/actions with one of the listed actions.Böyle bir eylem yok. Listelenen eylemlerden biriyle POST /v1/actions çağır. |
invalid_arguments | 400 | An argument is missing or malformed; the field is named in the response.Bir argüman eksik ya da hatalı biçimde; alanın adı cevapta yazıyor. |
confirm_token_invalid | 400 | The confirmation token is unknown or was already used. Preview the action again.Onay belirteci bilinmiyor ya da daha önce kullanılmış. Eylemi yeniden önizle. |
confirm_token_expired | 400 | The confirmation token expired. Preview the action again.Onay belirtecinin süresi doldu. Eylemi yeniden önizle. |
confirm_token_mismatch | 409 | The target changed after the preview. Preview the action again and re-read the diff.Hedef önizlemeden sonra değişti. Eylemi yeniden önizle ve farkı yeniden oku. |
write_limit_reached | 403 | This write is outside the guardrails for the action (see reason).Bu yazma, eylemin koruma sınırlarının dışında (reason alanına bak). |
key_in_url | 400 | API keys are not accepted in the URL, where logs and proxies keep them. Send the key in the x-api-key header (or Authorization: Bearer) and rotate this one.API anahtarları URL'de kabul edilmez; günlükler ve vekil sunucular onları orada saklar. Anahtarı x-api-key başlığında (ya da Authorization: Bearer ile) gönder ve bu anahtarı yenile. |
test_key_read_only | 403 | Test keys (sl_test_) never write.Test anahtarları (sl_test_) asla yazmaz. |
job_not_found | 404 | No such job in this workspace.Bu çalışma alanında böyle bir iş yok. |
workspace_suspended | 403 | This workspace is suspended. Contact support@storelift.net.Bu çalışma alanı askıya alındı. support@storelift.net ile iletişime geç. |
ip_list_required | 403 | This workspace requires every key to carry an IP allow list. Add one in Settings › API.Bu çalışma alanı her anahtarın bir IP kısıtı taşımasını şart koşuyor. Ayarlar › API'de ekle. |
already_measuring | 409 | A measurement for this app is already running.Bu uygulama için bir ölçüm zaten çalışıyor. |
ai_limit | 429 | This month's AI visibility runs are used. The response carries limit and resetsAt.Bu ayın AI görünürlüğü turları kullanıldı. Cevap limit ve resetsAt değerlerini taşır. |
in_progress | 409 | A write for this target is already running. Wait for it to finish.Bu hedef için bir yazma zaten çalışıyor. Bitmesini bekle. |
asc_required | 403 | Connect App Store Connect under Settings › Connections first.Önce Ayarlar › Bağlantılar altından App Store Connect'i bağla. |
asc_role | 403 | The App Store Connect key needs the Admin or App Manager role to edit metadata.Meta veriyi düzenlemek için App Store Connect anahtarının Admin ya da App Manager rolü olmalı. |
asc_rejected | 502 | App Store Connect refused the change; its own message is in detail.App Store Connect değişikliği reddetti; kendi mesajı detail içinde. |
asc_unavailable | 502 | App Store Connect could not be reached. Retry in a moment.App Store Connect'e ulaşılamadı. Birazdan yeniden dene. |
ios_only | 403 | This action needs the App Store side of the app.Bu eylem uygulamanın App Store tarafını gerektirir. |
no_editable_version | 404 | No editable App Store version. Metadata can only change while a version is in Prepare for Submission or rejected — the current states are listed.Düzenlenebilir App Store sürümü yok. Meta veri yalnızca bir sürüm Prepare for Submission durumundayken ya da reddedilmişken değişebilir — mevcut durumlar listelenir. |
locale_not_found | 404 | That storefront language is not on the version; the available locales are listed.O vitrin dili sürümde yok; kullanılabilir diller listelenir. |
changed_since_preview | 409 | The listing changed in App Store Connect after the preview. Nothing was written — preview again.Mağaza sayfası önizlemeden sonra App Store Connect'te değişti. Hiçbir şey yazılmadı — yeniden önizle. |
ai_text_limit | 429 | This month's AI writing allowance is used up. resetsAt says when it renews; Settings › Plan adds more.Bu ayın AI yazım hakkı bitti. resetsAt ne zaman yenileneceğini söyler; Ayarlar › Plan'dan daha fazlası eklenir. |
ai_not_configured | 503 | The AI writer is starting up. Retry in a moment.AI yazarı başlatılıyor. Birazdan yeniden dene. |
ai_failed | 502 | The AI writer returned an answer we could not read. Retry in a moment.AI yazarı okuyamadığımız bir cevap döndürdü. Birazdan yeniden dene. |
audit_failed | 502 | The storefront scan stopped midway. Start it again with refresh.Vitrin taraması yarıda durdu. refresh ile yeniden başlat. |
review_ai_limit | 429 | This month's Review AI allowance is used up. resetsAt says when it renews; Settings › Plan adds more.Bu ayın Yorum AI hakkı bitti. resetsAt ne zaman yenileneceğini söyler; Ayarlar › Plan'dan daha fazlası eklenir. |
review_not_found | 404 | No review with that id in the stored reviews for this storefront. Take the id from get_reviews or search_reviews.Bu vitrin için saklanan yorumlarda bu kimlikle bir yorum yok. Kimliği get_reviews ya da search_reviews'tan al. |
bad_locale | 400 | The locale is two letters, an underscore and two letters, e.g. de_de, pt_br.Dil kodu iki harf, bir alt çizgi ve iki harften oluşur, ör. de_de, pt_br. |
no_audit | 409 | Localization writes from the storefront audit's source listing. Run get_storefront_audit with start for this app, then call again.Yerelleştirme, vitrin analizinin kaynak sayfasından yazar. Bu uygulama için get_storefront_audit'i start ile çalıştır, sonra yeniden çağır. |
no_storefront | 409 | No storefront of this app reads that locale. Pick a locale the storefront audit lists.Bu uygulamanın hiçbir vitrini o dili okumuyor. Vitrin analizinin listelediği bir dil seç. |
measure_busy | 503 | Apple's search is answering slowly this minute; call again shortly. Nothing was used.Apple'ın araması şu dakika yavaş cevap veriyor; kısa süre sonra yeniden çağır. Hiçbir hak kullanılmadı. |
localize_quota | 429 | This plan's listing writes for the period are used. The response carries limit, used and period.Bu planın dönem için sayfa yazımı hakkı kullanıldı. Cevap limit, used ve period değerlerini taşır. |
no_job | 404 | No localization is running for that locale. Call without poll to start one.O dil için çalışan bir yerelleştirme yok. Başlatmak için poll olmadan çağır. |
ai_timeout | 504 | The AI writer took too long. Retry in a moment; the allowance was returned.AI yazarı çok uzun sürdü. Birazdan yeniden dene; hak iade edildi. |
not_found | 404 | No such app in this workspace.Bu çalışma alanında böyle bir uygulama yok. |
unknown_endpoint | 404 | No such endpoint.Böyle bir uç yok. |