# General Translation Platform: API-ключи
URL: https://generaltranslation.com/ru/docs/platform/dashboard/reference/api-keys.mdx
---

title: API-ключи
description: Создавайте API-ключи уровня Project и Organization и управляйте ими для приложений, локальной разработки и автоматизации.

---

API-ключи позволяют аутентифицировать ваши приложения, CLI и средства автоматизации в General Translation. Используйте ключ с минимально необходимой областью для вашего рабочего процесса.

## Области ключей [#key-scopes]

GT поддерживает две области API-ключей:

* **Organization keys** для автоматизации на уровне Organization. Используйте их для автоматизации на уровне организации или workflows, которым нужен доступ к нескольким Projects в рамках Organization.
* **Project keys** для одного Project. Используйте их для развернутых приложений, локальной разработки, превью и инструментов в области Project.

У Organization keys и Project keys разные способы создания. Project keys создаются как рабочие ключи или ключи разработки. Для Organization keys используется селектор разрешений.

## Создание ключей Organization [#create-organization-keys]

Создайте ключи Organization в разделе **Organization > API Keys**. Ключи Organization используют префикс `gtx-org-` и могут быть настроены с собственным набором разрешений.

Разрешения настраиваются отдельно для каждого ресурса. `Write` включает `Read`.

| Ресурс                  | Read                                    | Write or enabled                                                 |
| ----------------------- | --------------------------------------- | ---------------------------------------------------------------- |
| **Files**               | Чтение файлов проекта и переводов       | Загрузка исходного контента и запись переведённых файлов         |
| **Context**             | Чтение контекста проекта и Organization | Управление контекстными группами, Glossary и директивами         |
| **Runtime translation** | Неприменимо                             | Перевод контента по запросу                                      |
| **Translation queue**   | Неприменимо                             | Постановка задач перевода файлов в очередь для фоновой обработки |
| **Project settings**    | Неприменимо                             | Обновление настроек проекта, например локали по умолчанию        |

Предоставляйте каждому ключу только необходимые ему разрешения.

## Создание ключей проекта [#create-project-keys]

Создавайте ключи проекта в разделе **Project > API Keys**. Сразу скопируйте ключ целиком и сохраните его в переменных окружения, менеджере секретов или другом безопасном хранилище.

* **Рабочие ключи** начинаются с `gtx-api-`.
  * Используйте их в развернутых приложениях и автоматизации для продакшена. В продакшене для переводов используется опубликованный контент.
* **Ключи разработки** начинаются с `gtx-dev-`.
  * Используйте их для локальной разработки, preview-окружений и тестовой автоматизации. Ключи разработки позволяют тестировать переводы до публикации, не затрагивая ваше боевое приложение.
  * Не используйте ключи разработки в продакшене.

В большинстве сценариев работы с SDK и CLI используйте ключ вместе с вашим Project ID:

```bash
GT_API_KEY=gtx-api-...
GT_PROJECT_ID=...
```

## Управление ключами [#manage-keys]

Используйте понятные названия, чтобы ключи потом было легко находить.

Откройте список ключей в Project или Organization, чтобы просмотреть существующие ключи. В списке ключей отображаются:

* **Preview** — сокращённая версия ключа для удобного распознавания
* **Created At** — дата создания ключа
* **Last Used** — когда ключ использовался в последний раз
* **Delete** — чтобы отозвать ключ, который вам больше не нужен

Отзывайте ключи, которые больше не используются, и создавайте новые при ротации учётных данных.

## Рекомендации по безопасности [#security-practices]

* Никогда не коммитьте ключи в систему контроля версий.
* Храните ключи в переменных окружения или в менеджере секретов.
* Используйте отдельные ключи для разработки, стейджинга и продакшена.
* Регулярно меняйте ключи.
* Отзывайте неиспользуемые ключи.
* Выбирайте минимально необходимую для интеграции область.