Errores

Cada error es un sobre JSON con un código de máquina estable, un motivo opcional que lo precisa, un mensaje para las personas y el ID de solicitud para el soporte. Los clientes deciden por el código y el motivo, nunca por el texto del mensaje.

{ "code": "conflict", "reason": "version_exists", "message": "…", "requestId": "…" }

Códigos

Código	Estado HTTP	Significado
invalid_input	400	La solicitud está mal formada o un valor no está permitido; corrija la solicitud antes de enviarla de nuevo.
not_found	404	El objeto no existe, o quien llama no puede verlo.
conflict	409	La solicitud entra en conflicto con el estado actual; lea de nuevo el estado y decida después.
forbidden	403	La credencial es válida, pero no tiene el permiso para esta acción.
unauthorized	401	No hay una credencial válida: falta, es incorrecta, caducó o fue revocada.
capacity_exceeded	507	Se superaría una cuota, una capacidad o un límite.
integrity_mismatch	422	Los bytes no coinciden con el tamaño o el SHA-256 declarados.
busy	503	El servidor está en su límite de admisión; repita la solicitud después del plazo indicado en Retry-After.
unavailable	503	Una dependencia no está disponible en este momento; repita la solicitud después del plazo indicado en Retry-After.
rate_limited	429	Demasiados intentos; espere el plazo indicado en Retry-After.
read_only	405	Este servidor o esta puerta de enlace no acepta cambios (puerta de enlace de lectura o espejo).
internal	500	Un defecto inesperado del servidor; el ID de solicitud ayuda al soporte a encontrarlo. No repita la solicitud a ciegas.

Motivos

Código	Motivo	Estado HTTP	Significado
invalid_input	validation	400	Falta un campo o tiene un valor fuera de las reglas; details indica el campo.
invalid_input	malformed_json	400	El cuerpo no es JSON válido.
invalid_input	body_too_large	413	El cuerpo es más grande de lo que acepta esta operación.
invalid_input	unsupported_media_type	415	El Content-Type no es uno de los que acepta esta operación.
invalid_input	method_not_allowed	405	La ruta existe, pero no con este método.
invalid_input	range_not_satisfiable	416	El rango de bytes solicitado queda fuera del contenido.
not_found	route_not_found	404	No existe esa ruta.
conflict	upload_expired	409	La sesión de subida caducó antes de completarse.
conflict	upload_state	409	La subida no está en un estado que permita este paso.
conflict	revision_mismatch	409	La revisión esperada no es la actual (otro cambio llegó antes).
conflict	version_exists	409	Esta versión ya se publicó con otro contenido.
conflict	part_mismatch	409	Una parte no coincide con su tamaño o su SHA-256 declarados.
conflict	parts_incomplete	409	Todavía no han llegado todas las partes de la subida.
conflict	idempotency_mismatch	409	La Idempotency-Key ya se usó antes con una solicitud distinta.
conflict	already_exists	409	Ya existe un objeto con este nombre o ruta.
conflict	stage_limit	409	El artefacto tiene el número máximo de etapas.
conflict	state_conflict	409	El objeto está en un estado que no permite este cambio.
conflict	mirror_read_only	409	El repositorio es un espejo; solo cambia mediante la sincronización.
forbidden	permission_missing	403	La credencial no tiene la acción que necesita esta operación.
forbidden	read_only_token	403	Un token personal de solo lectura no puede cambiar nada.
forbidden	credential_revoked	403	La clave o el token fue revocado.
forbidden	session_required	403	Solo una sesión de cuenta iniciada puede hacerlo, no una clave.
forbidden	administrator_required	403	Solo un administrador puede hacerlo.
forbidden	registration_disabled	403	El autorregistro está desactivado en este servidor.
forbidden	origin_not_allowed	403	El origen del navegador no figura en ARKVORY_CORS_ORIGINS.
unauthorized	invalid_credentials	401	El nombre de la cuenta o la contraseña son incorrectos.
unauthorized	current_password_invalid	401	La contraseña actual es incorrecta.
unauthorized	credential_missing	401	La solicitud no lleva ninguna credencial.
unauthorized	credential_invalid	401	La credencial no es una clave, un token ni una sesión válidos.
unauthorized	session_expired	401	La sesión caducó; inicie sesión de nuevo.
unauthorized	token_expired	401	El token personal caducó.
capacity_exceeded	storage_quota	507	Se superaría la cuota del repositorio.
capacity_exceeded	storage_full	507	El disco del servidor conserva su reserva de espacio libre; no hay sitio para más.
capacity_exceeded	account_limit	507	El número de cuentas está en su límite.
capacity_exceeded	group_limit	507	El número de grupos está en su límite.
capacity_exceeded	membership_limit	507	El número de miembros de grupos está en su límite.
capacity_exceeded	grant_limit	507	El número de concesiones está en su límite.
capacity_exceeded	key_limit	507	El número de claves está en su límite.
capacity_exceeded	token_limit	507	El número de tokens personales está en su límite.
capacity_exceeded	delegation_limit	507	El número de delegaciones está en su límite.
capacity_exceeded	catalog_limit	507	Se superaría la capacidad del catálogo de la instalación.
capacity_exceeded	queue_full	507	La cola de transferencias está llena.
capacity_exceeded	transfer_limit	507	El solicitante ya tiene el máximo de transferencias permitidas.
busy	request_limit	503	El servidor ya atiende el máximo de solicitudes que admite.
busy	download_queued	503	La descarga espera en la cola; vuelva tras Retry-After. Arkvory-Queue-Position y Arkvory-Starts-At indican el puesto y el inicio previsto.
unavailable	feedback_disabled	503	Los comentarios están desactivados en este servidor.
unavailable	hub_unreachable	503	No se puede contactar con el hub de actualizaciones.
unavailable	replication_degraded	503	Un clúster HA tiene menos copias completas de las que necesita una escritura, por lo que el cambio no se confirmó; repítalo después de Retry-After. Las descargas siguen funcionando.
rate_limited	login_attempts	429	Demasiados intentos de inicio de sesión; espere.
rate_limited	registration_attempts	429	Demasiados intentos de registro; espere.
rate_limited	password_attempts	429	Demasiados intentos de contraseña; espere.
rate_limited	feedback_attempts	429	Demasiados envíos de comentarios; espere.