Fehlercodes
Jeder Fehler aus /v1 hat denselben Body. error ist ein stabiler Code, nach dem Sie verzweigen können; message erklärt ihn in einem Satz, und docs verlinkt hierher.
Fehlermeldungen stehen auf Englisch, so wie die API sie zurückgibt; darunter folgt die deutsche Fassung.
{
"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"
}| Code | Status | Meldung |
|---|---|---|
missing_api_key | 401 | Send the key in the Authorization: Bearer header or x-api-key.Senden Sie den Schlüssel im Header Authorization: Bearer oder in x-api-key. |
invalid_api_key | 401 | The key is not valid.Der Schlüssel ist nicht gültig. |
invalid_token | 401 | The access token is not valid or has expired.Das Zugriffstoken ist nicht gültig oder abgelaufen. |
account_deleted | 401 | The account behind this key was deleted.Das Konto hinter diesem Schlüssel wurde gelöscht. |
key_expired | 401 | The key has expired. Create a new one in Settings › API.Der Schlüssel ist abgelaufen. Erstellen Sie unter Einstellungen › API einen neuen. |
key_revoked | 401 | The key was revoked.Der Schlüssel wurde widerrufen. |
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.Dieser Schlüssel hat sein monatliches Credit-Budget aufgebraucht. Erhöhen oder entfernen Sie das Budget unter Einstellungen › API; andere Schlüssel sind nicht betroffen. |
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.Dieser Workspace hat mehr Live-Schlüssel, als ihm zustehen, daher ist dieser Schlüssel angehalten. Löschen Sie einen Schlüssel unter Einstellungen › API oder wechseln Sie in einen höheren Tarif. |
key_leaked | 401 | The key was revoked after it was found in a public repository. Create a new one in Settings › API.Der Schlüssel wurde widerrufen, nachdem er in einem öffentlichen Repository gefunden wurde. Erstellen Sie unter Einstellungen › API einen neuen. |
ip_not_allowed | 403 | This key is restricted to other IP addresses (Settings › API › IP allow list).Dieser Schlüssel ist auf andere IP-Adressen beschränkt (Einstellungen › API › IP-Allowlist). |
key_paused | 403 | The key is paused. Resume it in Settings › API.Der Schlüssel ist pausiert. Setzen Sie ihn unter Einstellungen › API fort. |
plan_required | 403 | The API is on the Pro plan and above; MCP is on every plan.Die API gibt es ab dem Pro-Tarif; MCP gibt es in jedem Tarif. |
scope_required | 403 | The key does not carry the scope this endpoint needs.Der Schlüssel enthält nicht den Bereich, den dieser Endpunkt benötigt. |
app_not_allowed | 403 | The key is restricted to other apps.Der Schlüssel ist auf andere Apps beschränkt. |
credits_exhausted | 402 | This month's API credits are used up.Die API-Credits dieses Monats sind aufgebraucht. |
rate_limited | 429 | Too many requests for this key. Slow down and retry.Zu viele Anfragen für diesen Schlüssel. Senden Sie langsamer und versuchen Sie es erneut. |
daily_hive_limit | 429 | Today's Hive request allowance is used up. It resets at 00:00 UTC.Das heutige Hive-Anfragekontingent ist aufgebraucht. Es wird um 00:00 UTC zurückgesetzt. |
bad_country | 400 | Send a two-letter storefront code, e.g. country=us.Senden Sie einen zweistelligen Storefront-Code, z. B. country=us. |
unsupported_platform | 400 | This metric source supports iOS. Send platform=ios.Diese Metrikquelle unterstützt iOS. Senden Sie platform=ios. |
bad_days | 400 | Send a whole number of days between 1 and 90.Senden Sie eine ganze Zahl von Tagen zwischen 1 und 90. |
hive_read_failed | 400 | Hive could not read this observation. Retry shortly.Hive konnte diese Beobachtung nicht lesen. Versuchen Sie es in Kürze erneut. |
hive_write_failed | 400 | Hive could not save this observation. Retry shortly.Hive konnte diese Beobachtung nicht speichern. Versuchen Sie es in Kürze erneut. |
bad_kind | 400 | kind must be one of grossing, free, paid, ipad.kind muss einer der Werte grossing, free, paid, ipad sein. |
bad_genre | 400 | Send genre as an App Store genre id (e.g. 6014) or a category key such as games.Senden Sie genre als Genre-ID des App Store (z. B. 6014) oder als Kategorieschlüssel wie games. |
bad_day | 400 | Send day as YYYY-MM-DD, no later than yesterday.Senden Sie day als YYYY-MM-DD, spätestens gestern. |
bad_goal | 400 | Send goal as downloads, rank or revenue.Senden Sie goal als downloads, rank oder revenue. |
bad_range | 400 | Send from and to as YYYY-MM-DD, from on or before to.Senden Sie from und to als YYYY-MM-DD, from am selben Tag wie to oder davor. |
bad_term | 400 | Send a keyword of 1–150 characters.Senden Sie ein Keyword mit 1–150 Zeichen. |
bad_app_id | 400 | Send an App Store id (digits) or a Play package name.Senden Sie eine App-Store-ID (Ziffern) oder einen Play-Paketnamen. |
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.Diese Quelle ist nicht mit dem Workspace verbunden. Verbinden Sie sie unter Einstellungen › Verbindungen. |
bad_query | 400 | Send q with 1–120 characters.Senden Sie q mit 1–120 Zeichen. |
bad_id | 400 | Send an id from a /v1/search result.Senden Sie eine ID aus einem Ergebnis von /v1/search. |
no_filters | 400 | Send at least one filter; the accepted filters are listed in filters.Senden Sie mindestens einen Filter; die akzeptierten Filter stehen in filters. |
bad_filter | 400 | A filter value is malformed; the field is named in the response. Ranges take numbers, min on or below max.Ein Filterwert ist fehlerhaft; das Feld wird in der Antwort genannt. Bereiche erwarten Zahlen, min kleiner oder gleich max. |
bad_cursor | 400 | The cursor is malformed or expired. Pass meta.pagination.nextCursor from the previous response unchanged.Der Cursor ist fehlerhaft oder abgelaufen. Übergeben Sie meta.pagination.nextCursor aus der vorherigen Antwort unverändert. |
bad_ids | 400 | Send ids as a comma-separated list, between min and max apps.Senden Sie ids als durch Komma getrennte Liste, mit einer App-Zahl zwischen min und max. |
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/apiDieser Endpunkt ist für dieses Konto nicht freigeschaltet. Hive-Endpunkte laufen über gekaufte API-Credits oder Hive Explorer; Keyword-Gap, Keyword-Recherche und Keyword-Metriken gibt es nur mit Hive Explorer. Siehe 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.Lesezugriffe sind GET; POST wird auf /v1/actions, /v1/actions/confirm, /v1/apps/{id}/validate-listing und /v1/hive/keywords/{term}/metrics/measure angenommen. |
bad_metrics | 400 | metrics is a list of popularity and/or difficulty, each at most once.metrics ist eine Liste aus popularity und/oder difficulty, jeweils höchstens einmal. |
bad_wait | 400 | wait is a whole number of seconds from 0 to 20.wait ist eine ganze Zahl von Sekunden von 0 bis 20. |
hive_measurement_unavailable | 503 | Hive measurement is not available right now. Nothing was used; retry shortly.Die Hive-Messung ist gerade nicht verfügbar. Es wurde nichts verbraucht; versuchen Sie es in Kürze erneut. |
hive_measurement_queue_failed | 503 | The measurement could not be queued. Nothing was charged; retry shortly.Die Messung konnte nicht eingereiht werden. Es wurde nichts berechnet; versuchen Sie es in Kürze erneut. |
hive_measurement_failed | 503 | The source attempt failed. Valid metrics stay in the response; retry later.Der Quellversuch ist fehlgeschlagen. Gültige Metriken bleiben in der Antwort; versuchen Sie es später erneut. |
hive_measurement_incomplete | 503 | The job finished without a result for every requested metric. Valid metrics stay in the response.Der Job endete, ohne für jede angeforderte Metrik ein Ergebnis zu liefern. Gültige Metriken bleiben in der Antwort. |
hive_measurement_deferred | 503 | The source deferred this job. Valid metrics stay in the response; retry later.Die Quelle hat diesen Job zurückgestellt. Gültige Metriken bleiben in der Antwort; versuchen Sie es später erneut. |
hive_measurement_not_started | 503 | No measurement job is running for this keyword. Retry the request.Für dieses Keyword läuft kein Messjob. Wiederholen Sie die Anfrage. |
unknown_action | 400 | No such action. Call POST /v1/actions with one of the listed actions.Diese Aktion gibt es nicht. Rufen Sie POST /v1/actions mit einer der aufgeführten Aktionen auf. |
invalid_arguments | 400 | An argument is missing or malformed; the field is named in the response.Ein Argument fehlt oder ist fehlerhaft; das Feld wird in der Antwort genannt. |
confirm_token_invalid | 400 | The confirmation token is unknown or was already used. Preview the action again.Das Bestätigungstoken ist unbekannt oder wurde bereits verwendet. Rufen Sie die Vorschau der Aktion erneut auf. |
confirm_token_expired | 400 | The confirmation token expired. Preview the action again.Das Bestätigungstoken ist abgelaufen. Rufen Sie die Vorschau der Aktion erneut auf. |
confirm_token_mismatch | 409 | The target changed after the preview. Preview the action again and re-read the diff.Das Ziel hat sich nach der Vorschau geändert. Rufen Sie die Vorschau der Aktion erneut auf und lesen Sie den Diff noch einmal. |
write_limit_reached | 403 | This write is outside the guardrails for the action (see reason).Dieser Schreibvorgang liegt außerhalb der Leitplanken für die Aktion (siehe reason). |
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-Schlüssel werden nicht in der URL akzeptiert, wo Logs und Proxys sie aufbewahren. Senden Sie den Schlüssel im Header x-api-key (oder Authorization: Bearer) und erneuern Sie diesen Schlüssel. |
test_key_read_only | 403 | Test keys (sl_test_) never write.Testschlüssel (sl_test_) schreiben nie. |
job_not_found | 404 | No such job in this workspace.Diesen Job gibt es in diesem Workspace nicht. |
workspace_suspended | 403 | This workspace is suspended. Contact support@storelift.net.Dieser Workspace ist gesperrt. Wenden Sie sich an support@storelift.net. |
ip_list_required | 403 | This workspace requires every key to carry an IP allow list. Add one in Settings › API.Dieser Workspace verlangt, dass jeder Schlüssel eine IP-Allowlist hat. Fügen Sie unter Einstellungen › API eine hinzu. |
already_measuring | 409 | A measurement for this app is already running.Für diese App läuft bereits eine Messung. |
ai_limit | 429 | This month's AI visibility runs are used. The response carries limit and resetsAt.Die KI-Sichtbarkeitsläufe dieses Monats sind aufgebraucht. Die Antwort enthält limit und resetsAt. |
in_progress | 409 | A write for this target is already running. Wait for it to finish.Für dieses Ziel läuft bereits ein Schreibvorgang. Warten Sie, bis er abgeschlossen ist. |
asc_required | 403 | Connect App Store Connect under Settings › Connections first.Verbinden Sie zuerst App Store Connect unter Einstellungen › Verbindungen. |
asc_role | 403 | The App Store Connect key needs the Admin or App Manager role to edit metadata.Der App-Store-Connect-Schlüssel braucht die Rolle Admin oder App Manager, um Metadaten zu bearbeiten. |
asc_rejected | 502 | App Store Connect refused the change; its own message is in detail.App Store Connect hat die Änderung abgelehnt; die eigene Meldung steht in detail. |
asc_unavailable | 502 | App Store Connect could not be reached. Retry in a moment.App Store Connect war nicht erreichbar. Versuchen Sie es gleich noch einmal. |
ios_only | 403 | This action needs the App Store side of the app.Diese Aktion benötigt die App-Store-Seite der App. |
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.Keine bearbeitbare App-Store-Version. Metadaten lassen sich nur ändern, solange eine Version im Status Prepare for Submission ist oder abgelehnt wurde — die aktuellen Status werden aufgeführt. |
locale_not_found | 404 | That storefront language is not on the version; the available locales are listed.Diese Storefront-Sprache gibt es in der Version nicht; die verfügbaren Sprachen werden aufgeführt. |
changed_since_preview | 409 | The listing changed in App Store Connect after the preview. Nothing was written — preview again.Die Produktseite wurde nach der Vorschau in App Store Connect geändert. Es wurde nichts geschrieben — rufen Sie die Vorschau erneut auf. |
ai_text_limit | 429 | This month's AI writing allowance is used up. resetsAt says when it renews; Settings › Plan adds more.Das KI-Schreibkontingent dieses Monats ist aufgebraucht. resetsAt nennt den Zeitpunkt der Erneuerung; unter Einstellungen › Tarif lässt sich mehr hinzufügen. |
ai_not_configured | 503 | The AI writer is starting up. Retry in a moment.Der KI-Autor startet gerade. Versuchen Sie es gleich noch einmal. |
ai_failed | 502 | The AI writer returned an answer we could not read. Retry in a moment.Der KI-Autor hat eine Antwort geliefert, die wir nicht lesen konnten. Versuchen Sie es gleich noch einmal. |
audit_failed | 502 | The storefront scan stopped midway. Start it again with refresh.Der Storefront-Scan ist mittendrin abgebrochen. Starten Sie ihn mit refresh erneut. |
review_ai_limit | 429 | This month's Review AI allowance is used up. resetsAt says when it renews; Settings › Plan adds more.Das Rezensions-KI-Kontingent dieses Monats ist aufgebraucht. resetsAt nennt den Zeitpunkt der Erneuerung; unter Einstellungen › Tarif lässt sich mehr hinzufügen. |
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.Unter den gespeicherten Rezensionen dieses Storefronts gibt es keine Rezension mit dieser ID. Nehmen Sie die ID aus get_reviews oder search_reviews. |
bad_locale | 400 | The locale is two letters, an underscore and two letters, e.g. de_de, pt_br.Der Sprachcode besteht aus zwei Buchstaben, einem Unterstrich und zwei Buchstaben, z. B. 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.Die Lokalisierung schreibt aus der Quell-Produktseite der Storefront-Prüfung. Führen Sie get_storefront_audit mit start für diese App aus und rufen Sie dann erneut auf. |
no_storefront | 409 | No storefront of this app reads that locale. Pick a locale the storefront audit lists.Kein Storefront dieser App liest diese Sprache. Wählen Sie eine Sprache, die die Storefront-Prüfung aufführt. |
measure_busy | 503 | Apple's search is answering slowly this minute; call again shortly. Nothing was used.Apples Suche antwortet in dieser Minute langsam; rufen Sie in Kürze erneut auf. Es wurde nichts verbraucht. |
localize_quota | 429 | This plan's listing writes for the period are used. The response carries limit, used and period.Die Produktseiten-Erstellungen dieses Tarifs für den Zeitraum sind aufgebraucht. Die Antwort enthält limit, used und period. |
no_job | 404 | No localization is running for that locale. Call without poll to start one.Für diese Sprache läuft keine Lokalisierung. Rufen Sie ohne poll auf, um eine zu starten. |
ai_timeout | 504 | The AI writer took too long. Retry in a moment; the allowance was returned.Der KI-Autor hat zu lange gebraucht. Versuchen Sie es gleich noch einmal; das Kontingent wurde zurückgegeben. |
not_found | 404 | No such app in this workspace.Diese App gibt es in diesem Workspace nicht. |
unknown_endpoint | 404 | No such endpoint.Diesen Endpunkt gibt es nicht. |