Codes d'erreur
Toutes les erreurs de /v1 ont le même corps. error est un code stable sur lequel vous pouvez brancher votre logique ; message l'explique en une phrase et docs renvoie à cette page.
Les messages d'erreur sont en anglais, tels que l'API les renvoie ; la traduction figure en dessous.
{
"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 | Statut | Message |
|---|---|---|
missing_api_key | 401 | Send the key in the Authorization: Bearer header or x-api-key.Envoyez la clé dans l’en-tête Authorization: Bearer ou x-api-key. |
invalid_api_key | 401 | The key is not valid.La clé n’est pas valide. |
invalid_token | 401 | The access token is not valid or has expired.Le jeton d’accès n’est pas valide ou a expiré. |
account_deleted | 401 | The account behind this key was deleted.Le compte associé à cette clé a été supprimé. |
key_expired | 401 | The key has expired. Create a new one in Settings › API.La clé a expiré. Créez-en une nouvelle dans Réglages › API. |
key_revoked | 401 | The key was revoked.La clé a été révoquée. |
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.Cette clé a épuisé son budget mensuel de crédits. Augmentez ou supprimez le budget dans Réglages › API ; les autres clés ne sont pas concernées. |
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.Cet espace de travail a plus de clés live qu’il n’y a droit ; cette clé est donc suspendue. Supprimez une clé dans Réglages › API ou passez au forfait supérieur. |
key_leaked | 401 | The key was revoked after it was found in a public repository. Create a new one in Settings › API.La clé a été révoquée après avoir été trouvée dans un dépôt public. Créez-en une nouvelle dans Réglages › API. |
ip_not_allowed | 403 | This key is restricted to other IP addresses (Settings › API › IP allow list).Cette clé est limitée à d’autres adresses IP (Réglages › API › IP autorisées). |
key_paused | 403 | The key is paused. Resume it in Settings › API.La clé est en pause. Réactivez-la dans Réglages › API. |
plan_required | 403 | The API is on the Pro plan and above; MCP is on every plan.L’API est disponible à partir du forfait Pro ; MCP l’est sur tous les forfaits. |
scope_required | 403 | The key does not carry the scope this endpoint needs.La clé ne porte pas la portée requise par ce point de terminaison. |
app_not_allowed | 403 | The key is restricted to other apps.La clé est limitée à d’autres apps. |
credits_exhausted | 402 | This month's API credits are used up.Les crédits API de ce mois sont épuisés. |
rate_limited | 429 | Too many requests for this key. Slow down and retry.Trop de requêtes pour cette clé. Ralentissez et réessayez. |
daily_hive_limit | 429 | Today's Hive request allowance is used up. It resets at 00:00 UTC.Le quota de requêtes Hive du jour est épuisé. Il est remis à zéro à 00:00 UTC. |
bad_country | 400 | Send a two-letter storefront code, e.g. country=us.Envoyez un code pays à deux lettres, p. ex. country=us. |
unsupported_platform | 400 | This metric source supports iOS. Send platform=ios.Cette source de métrique prend en charge iOS. Envoyez platform=ios. |
bad_days | 400 | Send a whole number of days between 1 and 90.Envoyez un nombre entier de jours entre 1 et 90. |
hive_read_failed | 400 | Hive could not read this observation. Retry shortly.Hive n’a pas pu lire cette observation. Réessayez dans un instant. |
hive_write_failed | 400 | Hive could not save this observation. Retry shortly.Hive n’a pas pu enregistrer cette observation. Réessayez dans un instant. |
bad_kind | 400 | kind must be one of grossing, free, paid, ipad.kind doit valoir grossing, free, paid ou ipad. |
bad_genre | 400 | Send genre as an App Store genre id (e.g. 6014) or a category key such as games.Envoyez genre sous forme d’identifiant de genre App Store (p. ex. 6014) ou de clé de catégorie telle que games. |
bad_day | 400 | Send day as YYYY-MM-DD, no later than yesterday.Envoyez day au format YYYY-MM-DD, au plus tard hier. |
bad_goal | 400 | Send goal as downloads, rank or revenue.Envoyez goal avec la valeur downloads, rank ou revenue. |
bad_range | 400 | Send from and to as YYYY-MM-DD, from on or before to.Envoyez from et to au format YYYY-MM-DD, from antérieur ou égal à to. |
bad_term | 400 | Send a keyword of 1–150 characters.Envoyez un mot-clé de 1 à 150 caractères. |
bad_app_id | 400 | Send an App Store id (digits) or a Play package name.Envoyez un identifiant App Store (chiffres) ou un nom de paquet Play. |
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.Cette source n’est pas connectée à l’espace de travail. Connectez-la dans Réglages › Connexions. |
bad_query | 400 | Send q with 1–120 characters.Envoyez q avec 1 à 120 caractères. |
bad_id | 400 | Send an id from a /v1/search result.Envoyez un identifiant issu d’un résultat de /v1/search. |
no_filters | 400 | Send at least one filter; the accepted filters are listed in filters.Envoyez au moins un filtre ; les filtres acceptés sont listés dans filters. |
bad_filter | 400 | A filter value is malformed; the field is named in the response. Ranges take numbers, min on or below max.Une valeur de filtre est mal formée ; le champ est nommé dans la réponse. Les plages prennent des nombres, min inférieur ou égal à max. |
bad_cursor | 400 | The cursor is malformed or expired. Pass meta.pagination.nextCursor from the previous response unchanged.Le curseur est mal formé ou a expiré. Passez meta.pagination.nextCursor de la réponse précédente tel quel. |
bad_ids | 400 | Send ids as a comma-separated list, between min and max apps.Envoyez ids sous forme de liste séparée par des virgules, avec un nombre d’apps compris entre min et 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/apiCe point de terminaison n’est pas ouvert sur ce compte. Les points de terminaison Hive fonctionnent avec des crédits API achetés ou avec Hive Explorer ; l’écart de mots-clés, la recherche de mots-clés et les métriques de mots-clés sont réservés à Hive Explorer. Voir 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.Les lectures se font en GET ; POST est accepté sur /v1/actions, /v1/actions/confirm, /v1/apps/{id}/validate-listing et /v1/hive/keywords/{term}/metrics/measure. |
bad_metrics | 400 | metrics is a list of popularity and/or difficulty, each at most once.metrics est une liste contenant popularity et/ou difficulty, chacune au plus une fois. |
bad_wait | 400 | wait is a whole number of seconds from 0 to 20.wait est un nombre entier de secondes de 0 à 20. |
hive_measurement_unavailable | 503 | Hive measurement is not available right now. Nothing was used; retry shortly.La mesure Hive n’est pas disponible pour le moment. Rien n’a été consommé ; réessayez dans un instant. |
hive_measurement_queue_failed | 503 | The measurement could not be queued. Nothing was charged; retry shortly.La mesure n’a pas pu être mise en file d’attente. Rien n’a été facturé ; réessayez dans un instant. |
hive_measurement_failed | 503 | The source attempt failed. Valid metrics stay in the response; retry later.La tentative auprès de la source a échoué. Les métriques valides restent dans la réponse ; réessayez plus tard. |
hive_measurement_incomplete | 503 | The job finished without a result for every requested metric. Valid metrics stay in the response.La tâche s’est terminée sans résultat pour toutes les métriques demandées. Les métriques valides restent dans la réponse. |
hive_measurement_deferred | 503 | The source deferred this job. Valid metrics stay in the response; retry later.La source a différé cette tâche. Les métriques valides restent dans la réponse ; réessayez plus tard. |
hive_measurement_not_started | 503 | No measurement job is running for this keyword. Retry the request.Aucune tâche de mesure n’est en cours pour ce mot-clé. Renvoyez la demande. |
unknown_action | 400 | No such action. Call POST /v1/actions with one of the listed actions.Action inconnue. Appelez POST /v1/actions avec l’une des actions listées. |
invalid_arguments | 400 | An argument is missing or malformed; the field is named in the response.Un argument est manquant ou mal formé ; le champ est nommé dans la réponse. |
confirm_token_invalid | 400 | The confirmation token is unknown or was already used. Preview the action again.Le jeton de confirmation est inconnu ou a déjà été utilisé. Prévisualisez de nouveau l’action. |
confirm_token_expired | 400 | The confirmation token expired. Preview the action again.Le jeton de confirmation a expiré. Prévisualisez de nouveau l’action. |
confirm_token_mismatch | 409 | The target changed after the preview. Preview the action again and re-read the diff.La cible a changé après l’aperçu. Prévisualisez de nouveau l’action et relisez le diff. |
write_limit_reached | 403 | This write is outside the guardrails for the action (see reason).Cette écriture sort des garde-fous de l’action (voir 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.Les clés API ne sont pas acceptées dans l’URL, où les journaux et les proxys les conservent. Envoyez la clé dans l’en-tête x-api-key (ou Authorization: Bearer) et renouvelez celle-ci. |
test_key_read_only | 403 | Test keys (sl_test_) never write.Les clés de test (sl_test_) n’écrivent jamais. |
job_not_found | 404 | No such job in this workspace.Aucune tâche de ce type dans cet espace de travail. |
workspace_suspended | 403 | This workspace is suspended. Contact support@storelift.net.Cet espace de travail est suspendu. Contactez support@storelift.net. |
ip_list_required | 403 | This workspace requires every key to carry an IP allow list. Add one in Settings › API.Cet espace de travail exige que chaque clé ait une liste d’IP autorisées. Ajoutez-en une dans Réglages › API. |
already_measuring | 409 | A measurement for this app is already running.Une mesure est déjà en cours pour cette app. |
ai_limit | 429 | This month's AI visibility runs are used. The response carries limit and resetsAt.Les mesures de visibilité IA de ce mois sont épuisées. La réponse contient limit et resetsAt. |
in_progress | 409 | A write for this target is already running. Wait for it to finish.Une écriture est déjà en cours pour cette cible. Attendez qu’elle se termine. |
asc_required | 403 | Connect App Store Connect under Settings › Connections first.Connectez d’abord App Store Connect dans Réglages › Connexions. |
asc_role | 403 | The App Store Connect key needs the Admin or App Manager role to edit metadata.La clé App Store Connect doit avoir le rôle Admin ou App Manager pour modifier les métadonnées. |
asc_rejected | 502 | App Store Connect refused the change; its own message is in detail.App Store Connect a refusé la modification ; son propre message figure dans detail. |
asc_unavailable | 502 | App Store Connect could not be reached. Retry in a moment.App Store Connect est injoignable. Réessayez dans un instant. |
ios_only | 403 | This action needs the App Store side of the app.Cette action nécessite la version App Store de l’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.Aucune version App Store modifiable. Les métadonnées ne peuvent changer que lorsqu’une version est à l’état Prepare for Submission ou a été rejetée — les états actuels sont listés. |
locale_not_found | 404 | That storefront language is not on the version; the available locales are listed.Cette langue n’est pas présente dans la version ; les langues disponibles sont listées. |
changed_since_preview | 409 | The listing changed in App Store Connect after the preview. Nothing was written — preview again.La fiche a changé dans App Store Connect après l’aperçu. Rien n’a été écrit — prévisualisez de nouveau. |
ai_text_limit | 429 | This month's AI writing allowance is used up. resetsAt says when it renews; Settings › Plan adds more.Le quota de rédaction IA de ce mois est épuisé. resetsAt indique quand il se renouvelle ; Réglages › Forfait permet d’en ajouter. |
ai_not_configured | 503 | The AI writer is starting up. Retry in a moment.Le rédacteur IA démarre. Réessayez dans un instant. |
ai_failed | 502 | The AI writer returned an answer we could not read. Retry in a moment.Le rédacteur IA a renvoyé une réponse que nous n’avons pas pu lire. Réessayez dans un instant. |
audit_failed | 502 | The storefront scan stopped midway. Start it again with refresh.L’analyse des pays s’est arrêtée en cours de route. Relancez-la avec refresh. |
review_ai_limit | 429 | This month's Review AI allowance is used up. resetsAt says when it renews; Settings › Plan adds more.Le quota IA des avis de ce mois est épuisé. resetsAt indique quand il se renouvelle ; Réglages › Forfait permet d’en ajouter. |
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.Aucun avis avec cet identifiant parmi les avis stockés pour ce pays. Prenez l’identifiant dans get_reviews ou search_reviews. |
bad_locale | 400 | The locale is two letters, an underscore and two letters, e.g. de_de, pt_br.Le code de langue se compose de deux lettres, d’un tiret bas et de deux lettres, p. ex. 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.La localisation rédige à partir de la fiche source de l’audit des pays. Exécutez get_storefront_audit avec start pour cette app, puis rappelez. |
no_storefront | 409 | No storefront of this app reads that locale. Pick a locale the storefront audit lists.Aucun pays de cette app ne lit cette langue. Choisissez une langue listée par l’audit des pays. |
measure_busy | 503 | Apple's search is answering slowly this minute; call again shortly. Nothing was used.La recherche d’Apple répond lentement en ce moment ; rappelez dans un instant. Rien n’a été consommé. |
localize_quota | 429 | This plan's listing writes for the period are used. The response carries limit, used and period.Les rédactions de fiche de ce forfait pour la période sont épuisées. La réponse contient limit, used et period. |
no_job | 404 | No localization is running for that locale. Call without poll to start one.Aucune localisation n’est en cours pour cette langue. Appelez sans poll pour en lancer une. |
ai_timeout | 504 | The AI writer took too long. Retry in a moment; the allowance was returned.Le rédacteur IA a mis trop de temps. Réessayez dans un instant ; le quota a été restitué. |
not_found | 404 | No such app in this workspace.Aucune app de ce type dans cet espace de travail. |
unknown_endpoint | 404 | No such endpoint.Point de terminaison inconnu. |