Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Cuando se usa HTTP el protocolo para acceder al contenido en un servidor que ejecuta IIS, el servidor devuelve un código numérico que indica el resultado de la solicitud y la naturaleza de la respuesta, incluido su éxito o error.
El primer dígito del código de estado clasifica la clase de respuesta, mientras que los dos últimos dígitos no tienen ningún propósito de clasificación. El primer dígito puede ser uno de los cinco valores:
- 1xx (Informativo): respuesta provisional que indica que la solicitud se recibió y continúa el procesamiento.
- 2xx (correcto): el servidor recibió y aceptó correctamente la solicitud de cliente.
- 3xx (Redireccionamiento): se requiere más acción para completar la solicitud.
- 4xx (error de cliente): se produjo un error que se originó con el explorador cliente y no se puede cumplir.
- 5xx (Error del servidor): el servidor encontró un error y se produjo un error en la solicitud.
Códigos de estado
A continuación se indican los códigos de estado HTTP posibles que devuelve una solicitud.
| Código de estado | Descripción |
|---|---|
| 200 | Éxito. |
| 400 | Uno de los parámetros de consulta falta o no es válido. Corrija los parámetros de la solicitud antes de volver a intentarlo. |
| 401 | No se pudo autenticar la solicitud. Compruebe que las credenciales se especifican y son válidas. |
| 403 | La solicitud no está autorizada. Compruebe el mensaje de error de detalles. Este código de estado suele indicar que ha usado todas las traducciones gratuitas proporcionadas con una suscripción de prueba. |
| 408 | No se pudo completar la solicitud porque falta un recurso. Compruebe el mensaje de error de detalles. Cuando la solicitud incluye una categoría personalizada, este código de estado suele indicar que el sistema de traducción personalizado aún no está disponible para atender solicitudes. La solicitud debe reintentarse después de un período de espera (por ejemplo, 1 minuto). |
| 429 | El servidor rechazó la solicitud porque el cliente superó los límites de solicitud. |
| 500 | Error inesperado. Si el error persiste, notifique con: fecha y hora del error, identificador de solicitud del encabezado de respuesta X-RequestId y identificador de cliente del encabezado de solicitud X-ClientTraceId. |
| 503 | Servidor no disponible temporalmente. Intente de nuevo la solicitud. Si el error persiste, notifique con: fecha y hora del error, identificador de solicitud del encabezado de respuesta X-RequestId y identificador de cliente del encabezado de solicitud X-ClientTraceId. |
Si se produce un error, la solicitud devuelve una respuesta de error JSON. El código de error es un número de 6 dígitos que combina el código de estado HTTP de 3 dígitos seguido de un número de 3 dígitos para clasificar aún más el error:
Códigos de error
Una respuesta de error estándar es un objeto JSON con el par nombre-valor denominado error. El valor también es un objeto JSON con propiedades:
-
code: código de error definido por el servidor. -
message: cadena que proporciona una representación legible del error.
Por ejemplo, un cliente con una suscripción de evaluación gratuita recibiría el siguiente error una vez agotada la cuota gratuita:
{
"error": {
"code":403001,
"message":"The operation isn't allowed because the subscription has exceeded its free quota."
}
}
El código de error es un número de 6 dígitos que combina el código de estado HTTP de 3 dígitos y otro número de 3 dígitos que ayuda a categorizar aún más el error. Los códigos de error comunes son:
| Código | Descripción |
|---|---|
| 400000 | Una de las entradas de la solicitud no es válida. |
| 400001 | El parámetro "scope" no es válido. |
| 400002 | El parámetro "category" no es válido. |
| 400003 | Falta un especificador de lenguaje o no es válido. |
| 400004 | Falta un especificador de script de destino ("To script") o no es válido. |
| 400005 | Falta un texto de entrada o no es válido. |
| 400006 | La combinación de lenguaje y script no es válida. |
| 400018 | Falta un especificador de script de origen ("From script") o no es válido. |
| 400019 | No se admite uno de los lenguajes especificados. |
| 400020 | Uno de los elementos de la matriz de texto de entrada no es válido. |
| 400021 | Falta un parámetro de la versión de API o no es válido. |
| 400023 | Uno de los pares de lenguaje especificados no es válido. |
| 400035 | El lenguaje fuente (campo "From") no es válido. |
| 400036 | Falta el lenguaje de destino (campo "To") o no es válido. |
| 400042 | Una de las opciones especificadas (campo "Options") no es válida. |
| 400043 | El identificador de seguimiento de cliente (campo ClientTraceId o encabezado X-ClientTraceId) falta o no es válido. |
| 400050 | El texto de entrada es demasiado largo. Consulte los límites de solicitud. |
| 400064 | Falta un parámetro "translation" o no es válido. |
| 400070 | El número de scripts de destino (parámetro ToScript) no coincide con el número de lenguajes de destino (parámetro To). |
| 400071 | Valor no válido para TextType. |
| 400072 | La matriz de texto de entrada tiene demasiados elementos. |
| 400073 | El parámetro de script no es válido. |
| 400074 | El cuerpo de la solicitud no es un JSON válido. |
| 400075 | La combinación de categoría y par de lenguaje no es válida. |
| 400077 | Se supera el tamaño máximo de la solicitud. Consulte los límites de solicitud. |
| 400079 | El sistema personalizado solicitado para la traducción entre, desde y hacia el lenguaje no existe. |
| 400080 | La transliteración no se admite para el idioma o el script. |
| 401000 | La solicitud no está autorizada porque faltan credenciales o no son válidas. |
| 401015 | "Las credenciales proporcionadas son para Speech API. Esta solicitud requiere credenciales para Text API. Use una suscripción a Translator". |
| 403000 | No se permite la operación. |
| 403001 | No se permite la operación porque la suscripción superó su cuota gratuita. |
| 405000 | El método de solicitud no se admite para el recurso solicitado. |
| 408001 | Se está preparando el sistema de traducción solicitado. Vuelva a intentarlo en unos minutos. |
| 408002 | La solicitud superó el tiempo de espera mientras se esperaba la secuencia entrante. El cliente no presentó una solicitud en el tiempo que el servidor estaba preparado para esperar. El cliente puede repetir la solicitud sin modificaciones en cualquier momento posterior. |
| 415000 | Falta el encabezado Content-Type o no es válido. |
| 429000, 429001, 429002 | El servidor rechazó la solicitud porque el cliente superó los límites de solicitud. |
| 500000 | Error inesperado. Si el error persiste, notifique la fecha y hora del error, el identificador de solicitud del encabezado de respuesta X-RequestId y el identificador de cliente del encabezado de solicitud X-ClientTraceId. |
| 503000 | El servicio no está disponible temporalmente. Vuelva a intentarlo. Si el error persiste, notifique la fecha y hora del error, el identificador de solicitud del encabezado de respuesta X-RequestId y el identificador de cliente del encabezado de solicitud X-ClientTraceId. |