Compartir vía


Translator 3.0: Transliterar

Convierte el texto en un idioma de un script a otro.

URL de la solicitud

Envíe una solicitud POST a:

https://api.cognitive.microsofttranslator.com/transliterate?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.
language Parámetro obligatorio.
Especifica el idioma del texto que se va a convertir de un script a otro. Los idiomas posibles se enumeran en el ámbito transliteration obtenido al consultar el servicio de sus idiomas admitidos.
fromScript Parámetro obligatorio.
Especifica el script que usa el texto de entrada. Busque los idiomas admitidos con el ámbito transliteration, para ver los scripts de entrada disponibles para el idioma seleccionado.
toScript Parámetro obligatorio.
Especifica el nombre del script de salida. Busque los idiomas admitidos con el ámbito transliteration, para ver los scripts de salida disponibles para la combinación de idiomas y el script de entrada seleccionados.

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, que representa la cadena que se va a convertir.

[
    {"Text":"こんにちは"},
    {"Text":"さようなら"}
]

Se aplican las siguientes limitaciones:

  • La matriz puede tener como máximo 10 elementos.
  • El valor de texto de un elemento de la matriz no puede superar los 1000 caracteres, incluidos los espacios.
  • El texto completo incluido en la solicitud no puede superar los 5000 caracteres, incluidos los espacios.

Response body

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

  • text: cadena que resulta de convertir la cadena de entrada al script de salida.

  • script: cadena que especifica el script que se usa en la salida.

Un ejemplo de respuesta JSON es:

[
    {"text":"konnnichiha","script":"Latn"},
    {"text":"sayounara","script":"Latn"}
]

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 también 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 convertir dos cadenas escritas en japonés a japonés escrito con el alfabeto latino.

Esta es la carga de JSON para la solicitud en este ejemplo:

[{"text":"こんにちは","script":"jpan"},{"text":"さようなら","script":"jpan"}]

Si está usando cURL en una ventana de línea de comandos que no admite caracteres Unicode, use la siguiente carga JSON y guárdela en un archivo denominado request.txt. Asegúrese de guardar el archivo con una codificación UTF-8.

curl -X POST "https://api.cognitive.microsofttranslator.com/transliterate?api-version=3.0&language=ja&fromScript=Jpan&toScript=Latn" -H "X-ClientTraceId: 875030C7-5380-40B8-8A03-63DACCF69C11" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d @request.txt