Налаштування API інтеграції

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

Отримання і використання API ключа

Щоб знайти API-ключ вашого проекту, увійдіть до свого облікового запису Crowdin. Знайдіть проект, відкрийте сторінку Налаштування проекту і активуйте вкладку API.

Зверніть увагу, що практично всі API-виклики вимагають ідентифікатор проекту (ID). Ви можете знайти ідентифікатор проекту безпосередньо над API-ключем.

Виконання запитів

Для кожного запиту API, який ви робите, вам потрібно надати ключ доступу API в якості основного параметра URI для аутентифікації. Тримайте ключ API в секреті! Він повинен бути захищений так само, як ваш звичайний пароль облікового запису.

Ось приклад і принцип формування URI запиту до API.

Типова URL API-виклику виглядає так: https://api.crowdin.com/api/project/. Перший заповнювач (ключове слово в дужках) містить ідентифікатор проекту. API-ключ доступу визначається як параметр URI.

Обмеження за запитами

Кількість одночасних API-викликів на обліковий запис становить 20 запитів. Якщо ліміт буде перевищено, з'явиться повідомлення з кодом помилки 429: "Досягнуто максимальну кількість одночасних запитів для цього кінцевого пункту. Спробуйте ще раз пізніше."

Використання Postman

Postman - це інструмент, який дозволяє вам працювати з Crowdin API простим способом.

Всі доступні методи Crowdin API вже зберігаються у вигляді колекції в Postman. Натисніть Виконати в Postman, щоб імпортувати і відкрити цю колекцію безпосередньо у вашій програмі Postman.

Методи