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. Создайте CrowdinApiClient объект и выберите необходимый API метод
    CrowdinApiClient crwdn = new Crwdn();
    crwdn.getInfo(credentials, parameters);
    Для вывода записи ответа:
    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 или есть вопросы? Связаться со службой поддержки.

Была ли эта статья полезной?