¿Qué significan los códigos de error HTTP como 400, 401, 403, 404, 429, 500, 502 y 503?
Los códigos de estado HTTP son respuestas estandarizadas utilizadas por servicios web y API.
Puede encontrar estos códigos al usar Polyosync, solucionando una integración o revisando información técnica sobre errores.
El significado de un código de estado es general. Su causa específica depende de la solicitud y del servicio que lo devolvió.
400 — Solicitud incorrecta
El servidor no pudo procesar la solicitud porque la información enviada era inválida o no cumplía con los requisitos esperados.
Verifique la entrada y la configuración de la solicitud.
401 — No autorizado
La solicitud carece de autenticación válida.
Verifique si la autorización de sesión o integración relevante es válida.
403 — Prohibido
El servidor entendió la solicitud pero no permite la acción solicitada.
Revise los permisos aplicables y las restricciones de acceso.
404 — No encontrado
No se pudo encontrar el recurso solicitado.
Verifique la referencia del recurso, la URL y el contexto del espacio de trabajo.
429 — Demasiadas solicitudes
El servicio está limitando las solicitudes porque se ha alcanzado un umbral de tasa aplicable.
Evite enviar repetidamente la misma solicitud. Revise cualquier orientación específica del proveedor sobre cuándo se pueden volver a intentar las solicitudes.
500 — Error interno del servidor
El servicio encontró una condición inesperada al procesar la solicitud.
Esto no identifica, por sí mismo, la causa subyacente.
502 — Puerta de enlace incorrecta
Un servicio que actúa como puerta de enlace recibió una respuesta inválida de un servicio ascendente.
Esto puede indicar un problema relacionado con un servicio dependiente.
503 — Servicio no disponible
El servicio no puede manejar la solicitud temporalmente.
Las causas posibles incluyen indisponibilidad temporal, sobrecarga o mantenimiento.
504 — Tiempo de espera de puerta de enlace
Una puerta de enlace no recibió una respuesta oportuna de un servicio ascendente.
Esto puede ocurrir cuando una operación dependiente tarda demasiado.
Distinciones importantes
Un error 401 no significa necesariamente que su cuenta haya sido eliminada.
Un error 403 no significa necesariamente que la plataforma esté fallando; el acceso puede estar restringido intencionalmente.
Un error 404 no prueba que un recurso nunca existió.
Un error de la serie 500 no identifica automáticamente a Polyosync como el componente que falla; la respuesta puede provenir de un servicio externo.
¿Qué debo hacer?
Registre el código de estado exacto, la operación que lo produjo, la hora aproximada y el servicio afectado.
Si la operación pudo haber modificado datos comerciales, verifique su resultado antes de volver a intentarlo.
¿Cuándo debo contactar al soporte?
Proporcione el código de estado junto con el contexto completo.
Un código numérico por sí solo rara vez es suficiente para determinar la causa raíz.