API Technology (TMS)

Nuestra API ve las entidades de aplicación (proyectos, trabajos, configuraciones) como recursos que pueden ser recuperados, creados, modificados y eliminados. 

Cada método HTTP representa una acción:

Las entidades utilizan una estructura plana cuando es posible para mantener buenos tiempos de respuesta. En lugar de incluir objetos secundarios completos en las respuestas, se contienen referencias que incluyen el ID, UID y algunos otros atributos. Se esperan objetos de referencia IDReference o UidReference para referirse a entidades relacionadas.

Todas las listas de respuestas están paginadas. Utilice los parámetros pageNumber y pageSize para recuperar los datos solicitados. El tamaño máximo de página es 50.

Documentación

OpenAPI 3.0 se utiliza para la documentación de API. Generadores de código Swagger son recomendados para el desarrollo de clientes.

Ejemplos de API

Obtener lista de todas las memorias de traducción

GET

/web/api2/v1/transMemories

Respuesta

200

{
    "pageNumber": 0,
    "contenido": [
        {
            "internalId": 1,
            "creadoPor": {
                "userName": "admin",
                "id": "3",
                "firstName": "Jan",
                "lastName": "Janocko",
                "role": "ADMIN",
                "email": "jan.janocko@phrase.com"
            },
            "cliente": null,
            "nota": "no es necesario usar en TM"
            "dateCreated": "2018-01-09T14:07:46+0000",
            "id": "1",
            "targetLangs": [
                "es",
                "it"
            ],
            "subdominio": null,
            "unidadDeNegocio": {
                "id": "1",
                "name": "Primera UN" ,
            },
            "idiomaFuente": "en",
            "dominio": null,
            "name": "Mi nueva TM"
        }
    ],
    "numberOfElements": 1,
    "totalElements": 1,
    "pageSize": 50,
    "totalPages": 1
}

crear nueva memoria de traducción

POST

/web/api2/v1/transMemories

{{
"name": "Mi nueva TM",
"idiomaFuente": "en",
"targetLangs": [
"es", "it-IT"
],
"unidadDeNegocio": {
"id": "1"
},
"nota": "no es necesario usar en TM"
}

Respuesta

201

{
    "internalId": 1,
    "creadoPor": {
        "userName": "admin",
        "id": "3",
        "firstName": "J",
        "lastName": "Jan",
        "role": "ADMIN",
        "email": "jan.j@phrase.com"
    },
    "cliente": null,
    "nota": "no es necesario usar en TM"
    "dateCreated": "2018-01-09T14:07:46+0000",
    "id": "1",
    "targetLangs": [
        "es",
        "it"
    ],
    "subdominio": null,
    "unidadDeNegocio": {
        "id": "1",
        "name": "Primera UN" ,
    },
    "idiomaFuente": "en",
    "dominio": null,
    "name": "Mi nueva TM"
}

Agregando Archivos Al Crear un Trabajo

Agrega este archivo al cuerpo de la solicitud como un archivo adjunto binario. Asegúrate de que Phrase y los encabezados Content-Disposition estén correctamente insertados.

Ejemplo de PHP desde Postman:

<?php

$request = new HttpRequest();
$request->setUrl('https://cloud.memsource.com/web/api2/v1/projects/%7BUID%20de%20tu%20proyecto%7D/jobs');
$request->setMethod(HTTP_METH_POST);

$request->setQueryData(array(
'token' => 'Tu token va aquí'
));

$request->setHeaders(array(
'postman-token' => 'ABC',
'cache-control' => 'no-cache',
'content-disposition' => 'filename*=UTF-8''Sample.txt',
'memsource' => '{\\"targetLangs\\":[\\"de\\",\\"fr\\",\\"es\\"],\\"callbackUrl\\":\\"https://my-shiny-service.com/consumeCallback\\",\\"importSettings\\":{\\"uid\\":\\"WF0T1SfSHxII09yKr0dZh9\\"}}'
));

try {
$response = $request->send();

echo $response->getBody();
} catch (HttpException $ex) {
echo $ex;
}

Manejo de Errores

Si hay un problema al manejar una solicitud de API, la siguiente JSON estructura será devuelta. El código de error siempre estará presente; la descripción detallada puede ser nula.

{ "errorCode": "InvalidArguments",
"errorDescription": "Falta el argumento requerido \"contraseña\" de tipo \"cadena\"." ,
}

Una respuesta de error se puede detectar leyendo el estado HTTP código de la respuesta. Si ocurre un error, nunca se establecerá en 2xx. El código de estado es 400 solicitud incorrecta, 401 o 403 por problemas de autenticación o autorización.

Reportando Problemas

Al informar un problema a Soporte Técnico, incluye lo siguiente en el informe: