API доступ: получение вашего ключа и что вы можете с ним делать

Teamopipe имеет REST API для чтения и записи ваших данных — создавайте сделки из внешних источников, синхронизируйте контакты с другими инструментами или извлекайте данные для отчетности. API доступ включен в каждый план.

Создание ключа API

1. Перейдите в Настройки → Интеграции.
2. В разделе API ключи нажмите Создать новый ключ.
3. Дайте ему имя, которое идентифицирует интеграцию, и просмотрите область видимости и предупреждение, которое показывает Teamopipe.
4. Скопируйте ключ и сохраните его в хранилище секретов или менеджере паролей.

Только администраторы рабочего пространства могут управлять ключами API. Никогда не вставляйте ключ в электронную почту, чат, билеты, исходный код или скриншоты, и используйте один ключ на интеграцию.

Использование ключа

Отправьте ключ в заголовке Authorization: Authorization: Bearer YOUR_API_KEY. Базовый URL — api.teamopipe.com/api/v2. Полная интерактивная документация находится на api.teamopipe.com/api/v2/docs.

Безопасное тестирование

1. Сначала выполните вызов чтения, например список пайплайнов.
2. Если он возвращает ваши данные, ключ работает.
3. Только после этого попробуйте запись с явно поддельной записью и удалите ее после этого.

Что охватывает API

• Сделки — создание, чтение, обновление, удаление; групповое создание, движение этапов, обновление пользовательских полей и экспорт CSV.
• Контакты — полный CRUD, групповое создание и upsert по адресу электронной почты.
• Организации — полный CRUD с групповыми операциями и экспортом CSV.
• Пайплайны и этапы — чтение пайплайнов; создание, переупорядочивание и переименование этапов.
• Пользовательские поля — создание и управление полями (вызываемые динамические поля в API) и установка их значений.
• Задачи — полный CRUD с групповыми операциями и экспортом CSV.
• Команды и члены — чтение деталей команды и членов, управление приглашениями.

Распространенные проблемы

• Запросы отклонены: ключ был скопирован неполностью или был удален.
• Ничего не создается: проверьте обязательные поля и идентификаторы в интерактивной документации.

Отзыв ключа

Перейдите в Настройки → Интеграции → API ключи и удалите ключ. Все, что его использует, теряет доступ немедленно.

Предпочитаете без кода? Используйте Zapier. Хотите работать с вашим CRM из Claude или ChatGPT? См. Teamopipe MCP — это не требует ключа API; вместо этого используется вход и одобрение рабочего пространства.

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

Если у вас есть вопросы по API, используйте чат в правом нижнем углу или форму обратной связи — обычно мы отвечаем в течение 4 часов в рабочие дни.