Las respuestas de error pueden ser devueltas por una variedad de razones, como que la API haya sido llamada incorrectamente, que se hayan utilizado parámetros incorrectos, un problema de permisos o autenticación, o que el recurso haya sido eliminado. Sólo enumeramos los códigos de error que probablemente enviaría la API.
Códigos de error
Los códigos de error son códigos de estado HTTP numéricos que proporcionan un breve mensaje a los usuarios finales describiendo el problema notificado. Estos errores pueden afectar al rendimiento de las operaciones y deberán resolverse para que la API funcione según lo previsto. Además, devolvemos una respuesta de texto legible por humanos.
Esta API devuelve los siguientes códigos de error:
Código de error | Significado |
400 | Bad Request -- La solicitud contiene una carga no válida. |
401 | No autorizado -- La clave API proporcionada no tiene permiso para realizar la operación. |
403 | Prohibido -- La clave API proporcionada no está permitida para realizar la operación. |
404 | No encontrado -- No se ha podido encontrar el recurso especificado. |
405 | Method Not Allowed -- La petición especificada no está permitida. |
406 | Not Acceptable -- El formato de la solicitud no es aceptable. El formato admitido es json. |
409 | Conflicto - La solicitud no ha podido completarse debido a un conflicto con el estado actual del recurso de destino. |
410 | Desaparecido -- El recurso ya no está disponible. |
422 | Entidad no procesada -- Conflictos lógicos en los parámetros proporcionados. |
429 | Demasiadas solicitudes -- Se han realizado demasiadas solicitudes para este intervalo. |
500 | Internal Server Error -- El servidor ha tenido un error inesperado. |
503 | Servicio no disponible -- El servidor está fuera de línea por mantenimiento. Vuelva a intentarlo más tarde. |