Translator 3.0: Detect

Artículo
09/02/2024

Identifica el idioma de un fragmento de texto.

URL de la solicitud

Envíe una solicitud POST a:

https://api.cognitive.microsofttranslator.com/detect?api-version=3.0

Consulte Compatibilidad de red virtual con el servicio Translator seleccionado para la configuración y el soporte técnico de la red privada y el punto de conexión privado.

Parámetros de solicitud

Los parámetros de solicitud que se pasaron en la cadena de consulta son:

Parámetro de consulta	Descripción
api-version	Parámetro obligatorio. Versión de la API que el cliente solicitó. El valor debe ser `3.0`.

Los encabezados de solicitud incluyen lo siguiente:

encabezados	Descripción
Encabezados de autenticación	Encabezado de solicitud obligatorio. Consulte las opciones disponibles para la autenticación.
Content-Type	Encabezado de solicitud obligatorio. Especifica el tipo de contenido de la carga. Los valores posibles son: `application/json`.
Content-Length	Opcional. Longitud del cuerpo de la solicitud.
X-ClientTraceId	Opcional. GUID generado por el cliente para identificar de forma única la solicitud. Puede omitir este encabezado si incluye el id. de seguimiento en la cadena de la consulta mediante un parámetro de consulta denominado `ClientTraceId`.

Cuerpo de la solicitud

El cuerpo de la solicitud es una matriz JSON. Cada elemento de la matriz es un objeto JSON con una propiedad de cadena denominada Text. La detección de idioma se aplica al valor de la propiedad Text. La detección automática de idioma funciona mejor con texto de entrada más largo. Un cuerpo de solicitud de muestra tiene el siguiente aspecto:

[
    { "Text": "Ich würde wirklich gerne Ihr Auto ein paar Mal um den Block fahren." }
]

Se aplican las siguientes limitaciones:

La matriz puede tener como máximo 100 elementos.
El texto completo incluido en la solicitud no puede superar los 50 000 caracteres, incluidos los espacios.

Response body

Una respuesta correcta es una matriz JSON con un resultado para cada cadena en la matriz de entrada. Un objeto del resultado incluye las siguientes propiedades:

language: Código del idioma detectado.
score: valor flotante que indica la confianza en el resultado. La puntuación varía entre cero y uno, y una puntuación baja indica una confianza baja.
isTranslationSupported: valor booleano que tiene el valor "true" si el idioma detectado es uno de los idiomas admitidos para la traducción de texto.
isTransliterationSupported: valor booleano que tiene el valor "true" si el idioma detectado es uno de los idiomas admitidos para la transliteración.
alternatives: Matriz de otros idiomas posibles. Cada elemento de la matriz es otro objeto las siguientes propiedades: language, score, isTranslationSupportedy isTransliterationSupported.

Un ejemplo de respuesta JSON es:

[

    {

        "language": "de",

        "score": 1.0,

        "isTranslationSupported": true,

        "isTransliterationSupported": false

    }

]

Encabezados de respuesta

encabezados	Descripción
X-RequestId	Valor generado por el servicio para identificar la solicitud y usarse con fines de solución de problemas.

Códigos de estado de respuesta

A continuación se indican los códigos de estado HTTP posibles que devuelve una solicitud.

Código de estado	Descripción
200	Correcto.
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 pudo autenticarse la solicitud. Compruebe que las credenciales que se especificaron sean correctas.
403	La solicitud no está autorizada. Compruebe los detalles del mensaje de error. Este código suele indicar que se usan todas las traducciones gratuitas proporcionadas con una suscripción de prueba.
429	El servidor rechazó la solicitud porque el cliente superó los límites de solicitud.
500	Se ha producido un error inesperado. Si el error continúa, notifíquelo con: fecha y hora del error, identificador de la solicitud del encabezado de respuesta `X-RequestId` e identificador de cliente del encabezado de solicitud `X-ClientTraceId`.
503	Servidor no disponible temporalmente. Vuelva a intentarlo. Si el error continúa, notifíquelo con: fecha y hora del error, identificador de la solicitud del encabezado de respuesta `X-RequestId` e 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 y otro número de 3 dígitos que ayuda a categorizar aún más el error. En la página de referencia de Traductor v3 pueden encontrarse los códigos de error comunes.

Ejemplos

En el ejemplo siguiente se muestra cómo recuperar los idiomas admitidos para la traducción de texto.

curl -X POST "https://api.cognitive.microsofttranslator.com/detect?api-version=3.0" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'What language is this text written in?'}]"

Compartir vía