API-Создание и настройка API-ключей | Поддержка eSputnik

Пользовательские данные

Email

Омниканальность

Автоматизация

API-ключи

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

Чтобы настроить интеграцию с вашей организацией в eSputnik, используйте API-ключ.

eSputnik API поддерживает Basic HTTP Access Authentication с использованием API-ключа.

Ключ дает доступ к данным из вашей учетной записи eSputnik, поэтому он должен быть защищен от несанкционированного доступа.

Чтобы авторизоваться и обратиться к ресурсам вашего аккаунта в eSputnik:

  • введите любое значение для username;
  • введите значение вашего API-ключа в поле password.

Пример авторизации с помощью API ключа для приложения Postman:

Postman

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

1. Перейдите в раздел “Настройки”, затем выберите вкладку API и нажмите кнопку “Новый ключ”.

Новый ключ

2. В поле "Описание" можно добавить информацию о том, какое именно приложение/сайт будет использовать этот ключ для доступа к вашему аккаунту в eSputnik. Это поможет в будущем легко идентифицировать данный API-ключ.

3. Откройте список и выберите права доступа для ключа API.

доступ

Обратите внимание

Следующие правила применимы ко всем версиям методов (/v1, /v2 и т.д.), если иное не уточнено отдельно.

4. Если нужно настроить несколько интеграций, вы можете создать ключ для каждой из них. Также для одной организации можно создать несколько ключей с разными правами доступа.

Вы можете найти все API-ключи на вкладке API. Каждый ключ содержит следующую информацию:

A. Собственно ключ (в скрытом виде), его можно скопировать, просто кликнув по нему
B. Кем создан ключ
C. Дата его создания
D. Права доступа
E. Описание
F. Статус (активен/неактивен).

Пример ключа

Права доступа

Доступ с API-ключом к ресурсам eSputnik устанавливается на этапе создания ключа. Вы можете дать полный доступ ко всем ресурсам и методам eSputnik API, выбрав опцию Full access to API, или ограничить его, выбрав:

  • Access to events
  • Access to events and contacts
  • Access to events and contacts (adding/updating)
  • Access to messages

Добавление API-ключей

Копирование ключа

Чтобы скопировать ключ:

  • Наведите курсор на номер ключа, чтобы появилась иконка “Копировать”.
  • Кликните иконку “Копировать”.

Копирование ключа

Активация и деактивация ключа

Ключ создается активным по умолчанию.

Чтобы деактивировать его:

1. Переместите ползунок напротив ключа в положение "Отключить ключ".

Отключить ключ

2. Подтвердите действие во всплывающем окне.

Подтверждение

Ключ будет деактивирован

Обратите внимание

Если ключ не используется в течение 90 дней, он отключается автоматически

Редактирование ключа

1. Кликните меню “Опции” (...) справа.

2. Выберите из списка пункт “Редактировать”.

Редактировать

3. Отредактируйте описание и/или права доступа и нажмите “Сохранить”.

Сохранить

Удаление ключа

Если ключ скомпрометирован, его можно навсегда удалить и создать новый для соответствующего приложения или сайта.

Чтобы удалить ключ:

1. Кликните меню “Опции” (...) справа.

2. Выберите “Удалить” из списка.

Удалить

3. Подтвердите действие во всплывающем окне.

Подтверждение

Безопасность API-ключа

API-ключи предоставляют доступ к данным вашей учетной записи eSputnik и должны быть защищены так же, как и ваш пароль. В частности, существует несколько распространенных сценариев, которые следует учитывать при работе с API-ключами.

  1. Не допускайте, чтоб ключ был виден на скриншотах или демо-видео. Затирания ключа может быть недостаточно — лучше “вырезать” его в графическом редакторе.
  2. Не отправляйте API-ключ по почте, так как если ваш почтовый аккаунт взломают, данные в eSputnik окажутся под угрозой.

Если вы заметили необычную, подозрительную или незнакомую активность в своей учетной записи, возможно, кто-то другой использует ваш ключ API без разрешения.

Выключите или удалите скомпрометированный ключ и создайте новый.

Остались вопросы?
Специалисты обязательно ответят и помогут решить вашу проблему!
Обратный звонок
Оставьте заявку – и наш специалист свяжется с вами в рабочее время.
Отправить заявку
Консультация в чате
Готовы к вашим вопросам!
Написать в чат
Электронная почта
Напишите в службу поддержки eSputnik.
Отправить email