PTC

Trouver les formats de fichier et les langues pris en charge via l'API

Utilisez ces points de terminaison de l'API pour découvrir quels formats de fichier source et quelles langues cibles votre projet prend en charge avant de créer des tâches de traduction.

Grâce à ces points de terminaison, vous pouvez interroger :

  • Les langues cibles disponibles pour votre projet (avec les codes ISO)
  • Les formats de fichier source que vous pouvez téléverser, ainsi que tous les formats de sortie de traduction supplémentaires que PTC peut générer pour ces fichiers

Tous les points de terminaison nécessitent un token d'API valide :

Authorization: Bearer YOUR_API_TOKEN

Liens rapides de l'API

Lister toutes les langues cibles

Récupère la liste des langues dans lesquelles votre projet peut être traduit. Vous pouvez également utiliser ce point de terminaison pour obtenir les codes ISO corrects lors de la création de tâches de traduction de contenu.

Requête HTTP

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

Paramètres

Ce point de terminaison n'accepte aucun paramètre.

Réponses

Réponse de succès

200 OKapplication/json
{
  "languages": [
    {
      "id": 123,
      "iso": "es",
      "name": "Spanish"
    },
    {
      "id": 124,
      "iso": "fr",
      "name": "French"
    },
    {
      "id": 125,
      "iso": "de",
      "name": "German"
    }
  ]
}
Schéma de réponse
Champ Type Description
languages array[object] Le tableau d'objets de langue cible configurés pour ce projet.
languages[].id integer L'identifiant unique de la langue.
languages[].iso string Le code de langue ISO 639-1 (par exemple en, es, fr).
languages[].name string Le nom lisible par l'humain de la langue.

Réponses d'erreur

Non autorisé
401 Unauthorized
{
  "error": "Unauthorized access. Please provide a valid API token."
}
Interdit
403 Forbidden
{
  "error": "Access denied. Insufficient permissions."
}

Exemples de requêtes

Requête de base :

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

Exemples de code

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);

Lister les formats de fichier pris en charge

Récupère toutes les extensions de fichier source que vous pouvez téléverser sur PTC, ainsi que tous les fichiers de traduction supplémentaires que PTC peut générer pour ces entrées.

Requête HTTP

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

Paramètres

Ce point de terminaison n'accepte aucun paramètre.

Réponses

Réponse de succès

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": []
    }
    //...
  ]
}
Schéma de réponse
Champ Type Description
extensions array Un tableau d'objets d'extension de fichier pris en charge.
extensions[].extension string L'extension de fichier, sans le point.
extensions[].additional_translation_files array Un tableau de formats de sortie supplémentaires disponibles pour ce type d'extension.
Fichiers de traduction supplémentaires

Certains types de fichiers peuvent générer des fichiers de traduction supplémentaires dans d'autres formats. Par exemple, les fichiers PO et POT peuvent produire :

  • mo – Fichiers gettext compilés, utilisés par de nombreuses applications pour un chargement plus rapide
  • wp – Fichiers de traduction JavaScript utilisés dans WordPress pour l'internationalisation côté client
  • php – Fichiers de traduction stockés sous forme de tableaux PHP

Exemples de code

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

Suite :

Demander et récupérer des traductions via l'API →