Códigos de error

Name: Storelift
Availability: InStock

Todos los errores de /v1 tienen el mismo cuerpo. error es un código estable en el que puede basar la lógica de su código; message lo explica en una frase y docs enlaza a esta página.

Los mensajes de error están en inglés, tal como los devuelve la API; debajo figura la traducción.

{
  "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"
}

Código	Estado	Mensaje
`missing_api_key`	401	Send the key in the Authorization: Bearer header or x-api-key.Envíe la clave en la cabecera Authorization: Bearer o en x-api-key.
`invalid_api_key`	401	The key is not valid.La clave no es válida.
`invalid_token`	401	The access token is not valid or has expired.El token de acceso no es válido o ha caducado.
`account_deleted`	401	The account behind this key was deleted.La cuenta a la que pertenecía esta clave se eliminó.
`key_expired`	401	The key has expired. Create a new one in Settings › API.La clave ha caducado. Cree una nueva en Ajustes › API.
`key_revoked`	401	The key was revoked.La clave se revocó.
`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.Esta clave ha agotado su presupuesto mensual de créditos. Aumente o elimine el presupuesto en Ajustes › API; las demás claves no se ven afectadas.
`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.Este espacio de trabajo tiene más claves activas de las que le corresponden, así que esta clave está en espera. Elimine una clave en Ajustes › API o mejore el plan.
`key_leaked`	401	The key was revoked after it was found in a public repository. Create a new one in Settings › API.La clave se revocó tras encontrarse en un repositorio público. Cree una nueva en Ajustes › API.
`ip_not_allowed`	403	This key is restricted to other IP addresses (Settings › API › IP allow list).Esta clave está restringida a otras direcciones IP (Ajustes › API › Lista de IP permitidas).
`key_paused`	403	The key is paused. Resume it in Settings › API.La clave está en pausa. Reanúdela en Ajustes › API.
`plan_required`	403	The API is on the Pro plan and above; MCP is on every plan.La API está en el plan Pro y superiores; MCP está en todos los planes.
`scope_required`	403	The key does not carry the scope this endpoint needs.La clave no lleva el ámbito que necesita este endpoint.
`app_not_allowed`	403	The key is restricted to other apps.La clave está restringida a otras apps.
`credits_exhausted`	402	This month's API credits are used up.Los créditos de API de este mes se han agotado.
`rate_limited`	429	Too many requests for this key. Slow down and retry.Demasiadas solicitudes para esta clave. Reduzca el ritmo y vuelva a intentarlo.
`daily_hive_limit`	429	Today's Hive request allowance is used up. It resets at 00:00 UTC.La cuota de solicitudes de Hive de hoy se ha agotado. Se reinicia a las 00:00 UTC.
`bad_country`	400	Send a two-letter storefront code, e.g. country=us.Envíe un código de tienda de dos letras, p. ej. country=us.
`unsupported_platform`	400	This metric source supports iOS. Send platform=ios.Esta fuente de métricas es compatible con iOS. Envíe platform=ios.
`bad_days`	400	Send a whole number of days between 1 and 90.Envíe un número entero de días entre 1 y 90.
`hive_read_failed`	400	Hive could not read this observation. Retry shortly.Hive no pudo leer esta observación. Vuelva a intentarlo en breve.
`hive_write_failed`	400	Hive could not save this observation. Retry shortly.Hive no pudo guardar esta observación. Vuelva a intentarlo en breve.
`bad_kind`	400	kind must be one of grossing, free, paid, ipad.kind debe ser uno de 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.Envíe genre como un id de género de App Store (p. ej. 6014) o una clave de categoría como games.
`bad_day`	400	Send day as YYYY-MM-DD, no later than yesterday.Envíe day como YYYY-MM-DD, no posterior a ayer.
`bad_goal`	400	Send goal as downloads, rank or revenue.Envíe goal como downloads, rank o revenue.
`bad_range`	400	Send from and to as YYYY-MM-DD, from on or before to.Envíe from y to como YYYY-MM-DD, con from igual o anterior a to.
`bad_term`	400	Send a keyword of 1–150 characters.Envíe una palabra clave de 1–150 caracteres.
`bad_app_id`	400	Send an App Store id (digits) or a Play package name.Envíe un id de App Store (dígitos) o un nombre de paquete de 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.Esta fuente no está conectada al espacio de trabajo. Conéctela en Ajustes › Conexiones.
`bad_query`	400	Send q with 1–120 characters.Envíe q con 1–120 caracteres.
`bad_id`	400	Send an id from a /v1/search result.Envíe un id de un resultado de /v1/search.
`no_filters`	400	Send at least one filter; the accepted filters are listed in filters.Envíe al menos un filtro; los filtros aceptados se enumeran en filters.
`bad_filter`	400	A filter value is malformed; the field is named in the response. Ranges take numbers, min on or below max.El valor de un filtro tiene un formato incorrecto; la respuesta indica el campo. Los rangos admiten números, con min igual o inferior a max.
`bad_cursor`	400	The cursor is malformed or expired. Pass meta.pagination.nextCursor from the previous response unchanged.El cursor tiene un formato incorrecto o ha caducado. Envíe meta.pagination.nextCursor de la respuesta anterior sin modificarlo.
`bad_ids`	400	Send ids as a comma-separated list, between min and max apps.Envíe ids como una lista separada por comas, con entre min y max apps.
`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/apiEste endpoint no está abierto en esta cuenta. Los endpoints de Hive funcionan con créditos de API comprados o con Hive Explorer; los huecos de palabras clave, la investigación de palabras clave y las métricas de palabras clave son exclusivos de Hive Explorer. Consulte 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.Las lecturas son GET; POST se acepta en /v1/actions, /v1/actions/confirm, /v1/apps/{id}/validate-listing y /v1/hive/keywords/{term}/metrics/measure.
`bad_metrics`	400	metrics is a list of popularity and/or difficulty, each at most once.metrics es una lista con popularity o difficulty (o ambas), cada una como máximo una vez.
`bad_wait`	400	wait is a whole number of seconds from 0 to 20.wait es un número entero de segundos de 0 a 20.
`hive_measurement_unavailable`	503	Hive measurement is not available right now. Nothing was used; retry shortly.La medición de Hive no está disponible en este momento. No se consumió nada; vuelva a intentarlo en breve.
`hive_measurement_queue_failed`	503	The measurement could not be queued. Nothing was charged; retry shortly.La medición no se pudo poner en cola. No se cobró nada; vuelva a intentarlo en breve.
`hive_measurement_failed`	503	The source attempt failed. Valid metrics stay in the response; retry later.El intento con la fuente falló. Las métricas válidas permanecen en la respuesta; vuelva a intentarlo más tarde.
`hive_measurement_incomplete`	503	The job finished without a result for every requested metric. Valid metrics stay in the response.El trabajo terminó sin obtener un resultado para cada métrica solicitada. Las métricas válidas permanecen en la respuesta.
`hive_measurement_deferred`	503	The source deferred this job. Valid metrics stay in the response; retry later.La fuente aplazó este trabajo. Las métricas válidas permanecen en la respuesta; vuelva a intentarlo más tarde.
`hive_measurement_not_started`	503	No measurement job is running for this keyword. Retry the request.No hay ningún trabajo de medición en curso para esta palabra clave. Repita la solicitud.
`unknown_action`	400	No such action. Call POST /v1/actions with one of the listed actions.No existe esa acción. Llame a POST /v1/actions con una de las acciones enumeradas.
`invalid_arguments`	400	An argument is missing or malformed; the field is named in the response.Falta un argumento o tiene un formato incorrecto; la respuesta indica el campo.
`confirm_token_invalid`	400	The confirmation token is unknown or was already used. Preview the action again.El token de confirmación es desconocido o ya se usó. Previsualice la acción de nuevo.
`confirm_token_expired`	400	The confirmation token expired. Preview the action again.El token de confirmación ha caducado. Previsualice la acción de nuevo.
`confirm_token_mismatch`	409	The target changed after the preview. Preview the action again and re-read the diff.El destino cambió después de la vista previa. Previsualice la acción de nuevo y vuelva a leer el diff.
`write_limit_reached`	403	This write is outside the guardrails for the action (see reason).Esta escritura queda fuera de los límites de seguridad de la acción (consulte 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.Las claves de API no se aceptan en la URL, donde los registros y los proxies las conservan. Envíe la clave en la cabecera x-api-key (o Authorization: Bearer) y sustituya esta por una nueva.
`test_key_read_only`	403	Test keys (sl_test_) never write.Las claves de prueba (sl_test_) nunca escriben.
`job_not_found`	404	No such job in this workspace.No existe ese trabajo en este espacio de trabajo.
`workspace_suspended`	403	This workspace is suspended. Contact support@storelift.net.Este espacio de trabajo está suspendido. Escriba a support@storelift.net.
`ip_list_required`	403	This workspace requires every key to carry an IP allow list. Add one in Settings › API.Este espacio de trabajo exige que todas las claves tengan una lista de IP permitidas. Añada una en Ajustes › API.
`already_measuring`	409	A measurement for this app is already running.Ya hay una medición en curso para esta app.
`ai_limit`	429	This month's AI visibility runs are used. The response carries limit and resetsAt.Las ejecuciones de visibilidad en IA de este mes se han agotado. La respuesta incluye limit y resetsAt.
`in_progress`	409	A write for this target is already running. Wait for it to finish.Ya hay una escritura en curso para este destino. Espere a que termine.
`asc_required`	403	Connect App Store Connect under Settings › Connections first.Conecte antes App Store Connect en Ajustes › Conexiones.
`asc_role`	403	The App Store Connect key needs the Admin or App Manager role to edit metadata.La clave de App Store Connect necesita el rol Admin o App Manager para editar los metadatos.
`asc_rejected`	502	App Store Connect refused the change; its own message is in detail.App Store Connect rechazó el cambio; su mensaje está en detail.
`asc_unavailable`	502	App Store Connect could not be reached. Retry in a moment.No se pudo conectar con App Store Connect. Vuelva a intentarlo en un momento.
`ios_only`	403	This action needs the App Store side of the app.Esta acción necesita la versión de App Store de la 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.No hay ninguna versión de App Store editable. Los metadatos solo se pueden cambiar mientras una versión está en Prepare for Submission o rechazada; se enumeran los estados actuales.
`locale_not_found`	404	That storefront language is not on the version; the available locales are listed.Ese idioma de tienda no está en la versión; se enumeran los códigos regionales disponibles.
`changed_since_preview`	409	The listing changed in App Store Connect after the preview. Nothing was written — preview again.La ficha cambió en App Store Connect después de la vista previa. No se escribió nada; previsualice de nuevo.
`ai_text_limit`	429	This month's AI writing allowance is used up. resetsAt says when it renews; Settings › Plan adds more.La cuota de redacción con IA de este mes se ha agotado. resetsAt indica cuándo se renueva; en Ajustes › Plan puede ampliarla.
`ai_not_configured`	503	The AI writer is starting up. Retry in a moment.El redactor de IA se está iniciando. Vuelva a intentarlo en un momento.
`ai_failed`	502	The AI writer returned an answer we could not read. Retry in a moment.El redactor de IA devolvió una respuesta que no pudimos leer. Vuelva a intentarlo en un momento.
`audit_failed`	502	The storefront scan stopped midway. Start it again with refresh.El análisis de tiendas se detuvo a mitad. Inícielo de nuevo con refresh.
`review_ai_limit`	429	This month's Review AI allowance is used up. resetsAt says when it renews; Settings › Plan adds more.La cuota de IA de reseñas de este mes se ha agotado. resetsAt indica cuándo se renueva; en Ajustes › Plan puede ampliarla.
`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.No hay ninguna reseña con ese id entre las reseñas guardadas de esta tienda. Tome el id de get_reviews o search_reviews.
`bad_locale`	400	The locale is two letters, an underscore and two letters, e.g. de_de, pt_br.El código regional son dos letras, un guion bajo y dos letras, p. ej. 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 localización se redacta a partir de la ficha de origen del análisis de tiendas. Ejecute get_storefront_audit con start para esta app y vuelva a llamar.
`no_storefront`	409	No storefront of this app reads that locale. Pick a locale the storefront audit lists.Ninguna tienda de esta app usa ese código regional. Elija uno de los que enumera el análisis de tiendas.
`measure_busy`	503	Apple's search is answering slowly this minute; call again shortly. Nothing was used.La búsqueda de Apple responde con lentitud en este momento; vuelva a llamar en breve. No se consumió nada.
`localize_quota`	429	This plan's listing writes for the period are used. The response carries limit, used and period.Las redacciones de ficha de este plan para el periodo se han agotado. La respuesta incluye limit, used y period.
`no_job`	404	No localization is running for that locale. Call without poll to start one.No hay ninguna localización en curso para ese código regional. Llame sin poll para iniciar una.
`ai_timeout`	504	The AI writer took too long. Retry in a moment; the allowance was returned.El redactor de IA tardó demasiado. Vuelva a intentarlo en un momento; la cuota se devolvió.
`not_found`	404	No such app in this workspace.No existe esa app en este espacio de trabajo.
`unknown_endpoint`	404	No such endpoint.No existe ese endpoint.