Crowdin API Java SDK

Бібліотека Java для доступу до Crowdin API. Crowdin надає RESTful API з XML або JSON через HTTP, використовуючи методи GET або POST. За допомогою цього SDK ви можете згладити роботу з усіма методами Crowdin API в вашому проекті Java, такими як додавання і оновлення файлів, завантаження перекладів або інтеграція локалізації з процесом розробки.

Системні вимоги

  • Java JDK 7 або новіше
  • Gradle

Швидкий старт

  1. Клонування сховища
    git clone https://github.com/crowdin/crowdin-java-sdk.git
  2. Оновіть залежності проекту, використовуючи gradle
  3. Зберіть проект, щоб вийшов jar-файл:
    gradle buildJavaSdkJar
  4. Додайте цей файл в ваш проект

Робимо Перший виклик

Після завершення встановлення ви можете зробити перший виклик:

  1. Створіть змінні для API-ключа, ідентифікатора проекту, ключа облікового запису, базового URL і збережіть їх значення. Скористайтеся додаткова інформація, щоб дізнатися як отримати API-ключ вашого проекту.
    public static final String  BASE_URL = "https://api.crowdin.com/api/";
    public static final String  PROJECT_IDENTIFIER = "your-project-identifier";
    public static final String  PROJECT_KEY = "your-project-key";
    public static final String  ACCOUNT_KEY = "your-account-key";
  2. Створіть об'єкт Credentials з належними конфігураціями
    Credentials credentials = new Credentials(BASE_URL, PROJECT_IDENTIFIER, PROJECT_KEY, ACCOUNT_KEY);
  3. Створіть об'єкт CrowdinApiParametersBuilder та вкажіть параметри, необхідні для обраного методу (Див. перелік методів API у Crowdin та їх параметри)
    CrowdinApiParametersBuilder parameters = new CrowdinApiParametersBuilder();
    parameters.json();
  4. Create CrowdinApiClient object and choose the necessary API method
    CrowdinApiClient crwdn = new Crwdn();
    crwdn.getInfo(credentials, parameters);
    For output the response's entity:
    System.out.println(crwdn.getInfo(credentials, parameters).getEntity(String.class));
  5. Виконайте код за допомогою IDE або командного рядка. Повинно повернутися щось на зразок цього:
    {
      "languages":[...],
      "files":[...],
      "details":{
        "source_language":{
          "name":"Ukrainian",
          "code":"uk"
        },
        "name":"crowdin2",
        "identifier":"crowdin2",
        "created":"2016-11-09 07:20:33",
        "description":"",
        "join_policy":"private",
        "last_build":"2016-12-07 10:00:27",
        "last_activity":"2016-12-16 08:53:32",
        "participants_count":"1",
        "total_strings_count":"24",
        "total_words_count":"24",
        "duplicate_strings_count":22,
        "duplicate_words_count":22,
        "invite_url":{
          "translator":"https:\/\/crowdin.com\/project\/crowdin2\/invite?d=b555o4i6o6f5h5b3m4c333453",
          "proofreader":"https:\/\/crowdin.com\/project\/crowdin2\/invite?d=755565j6b6f5h5b3m4c3455323"
        }
      }
    }

Потрібна допомога в роботі з Crowdin API Java SDK або є які-небудь питання? Зв’язатись з командою підтримки.

Ця стаття була корисною?