PTC

Encuentre los formatos de archivo y los idiomas compatibles a través de la API.

Utilice estos puntos de conexión de la API para descubrir qué formatos de archivo de origen e idiomas de destino admite su proyecto antes de crear trabajos de traducción.

Mediante estos puntos de conexión, puede consultar:

  • Idiomas de destino disponibles para su proyecto (con códigos ISO)
  • Formatos de archivo de origen que puede cargar, además de cualquier formato de salida de traducción adicional que PTC pueda generar para esos archivos

Todos los puntos de conexión requieren un token de API válido:

Authorization: Bearer YOUR_API_TOKEN

Enlaces rápidos de la API

Listar todos los idiomas de destino

Recupera la lista de idiomas a los que se puede traducir su proyecto. También puede utilizar este punto de conexión para obtener los códigos ISO correctos al crear trabajos de traducción de contenido.

Solicitud HTTP

GET https://app.ptc.wpml.org/api/v1/languages

Parámetros

Este punto de conexión no acepta ningún parámetro.

Respuestas

Respuesta correcta

200 OKapplication/json
{
  "languages": [
    {
      "id": 123,
      "iso": "es",
      "name": "Spanish"
    },
    {
      "id": 124,
      "iso": "fr",
      "name": "French"
    },
    {
      "id": 125,
      "iso": "de",
      "name": "German"
    }
  ]
}
Esquema de respuesta
Campo Tipo Descripción
languages array[object] La matriz de objetos de idioma de destino configurados para este proyecto.
languages[].id entero El identificador único del idioma.
languages[].iso cadena El código de idioma ISO 639-1 (p. ej., en, es, fr).
languages[].name cadena El nombre legible del idioma.

Respuestas de error

No autorizado
401 Unauthorized
{
  "error": "Unauthorized access. Please provide a valid API token."
}
Prohibido
403 Forbidden
{
  "error": "Access denied. Insufficient permissions."
}

Ejemplo de solicitudes

Solicitud básica:

curl -X GET "https://app.ptc.wpml.org/api/v1/languages" \
  -H "Content-Type: application/json"

Ejemplos de código

const response = await fetch('https://app.ptc.wpml.org/api/v1/languages', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log('Available target languages:', data.languages);

// Get language codes only
const languageCodes = data.languages.map(lang => lang.iso);
console.log('Language codes:', languageCodes);

Listar los formatos de archivo compatibles

Recupera todas las extensiones de archivo de origen que puede cargar en PTC, junto con cualquier archivo de traducción adicional que PTC pueda generar para esas entradas.

Solicitud HTTP

GET https://app.ptc.wpml.org/api/v1/source_files/supported_extensions

Parámetros

Este punto de conexión no acepta ningún parámetro.

Respuestas

Respuesta correcta

200 OKapplication/json
{
  "extensions": [
    {
      "extension": "po",
      "additional_translation_files": ["mo", "wp", "php"]
    },
    {
      "extension": "pot",
      "additional_translation_files": ["mo", "wp", "php"]
    },
    {
      "extension": "json",
      "additional_translation_files": []
    },
    {
      "extension": "yml",
      "additional_translation_files": []
    }
    //...
  ]
}
Esquema de respuesta
Campo Tipo Descripción
extensions array Una matriz de objetos de extensión de archivo compatibles.
extensions[].extension cadena La extensión de archivo, sin el punto.
extensions[].additional_translation_files array Una matriz de formatos de salida adicionales disponibles para este tipo de extensión.
Archivos de traducción adicionales

Algunos tipos de archivo pueden generar archivos de traducción adicionales en otros formatos. Por ejemplo, los archivos PO y POT pueden producir:

  • mo – Archivos gettext compilados, utilizados por muchas aplicaciones para una carga más rápida
  • wp – Archivos de traducción de JavaScript utilizados en WordPress para la internacionalización del lado del cliente
  • php – Archivos de traducción almacenados como matrices PHP

Ejemplos de código

curl -X GET "https://app.ptc.wpml.org/api/v1/source_files/supported_extensions" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Siguiente:

Solicite y recupere traducciones a través de la API →