SeeBotRun — ссылка (предварительная версия)

Динамически создавайте ссылки для учетной записи SeeBotRun Link.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Поддержка SeeBotRun
URL https://www.seebot.run/contact-us/
Адрес электронной почты support@seebot.run
Метаданные соединителя
Publisher SeeBotRun
Веб-сайт https://www.seebot.run
Privacy Policy (Политика конфиденциальности) https://portal.seebot.run/
Категории Коммуникация; Маркетинг

Соединитель SeeBotRun Link позволяет организациям создавать короткие URL-адреса и управлять ими, используя связанные домены со своими учетными записями.

Capabilities

  • Создание, обновление и удаление ссылок в учетной записи. Управление стандартными короткими ссылками или предопределенными ссылками.
  • Создание, обновление и удаление предопределенных ссылок в стандартной короткой ссылке.

Предпосылки

Существующая учетная запись с SeeBotRun и доступ к платформе Link. Узнайте, как создать учетную запись

Получение учетных данных

  • У вас есть учетная запись с SeeBotRun (см. предварительные требования).
  • После входа щелкните ссылку "Поддержка" в заголовке, выберите "Ссылка в качестве приложения" и добавьте сообщение "Запрос ключа API для Power Automate".
  • Ключ API, маркер пользователя и идентификатор пользователя будут отправлены вам по электронной почте безопасно.

Поддерживаемые операции

  • Создание и обновление и удаление ссылок Ссылки можно создавать, обновлять и удалять с помощью соединителя. Примечание. При обновлении ссылок, созданных за пределами соединителя, все теги и маркетинговые сведения будут удалены.
  • Создание, обновление и удаление предопределенных ссылок Предопределенные ссылки (ссылки второго уровня) можно создать под ссылкой, если для типа ссылки задано значение predefined. Предопределенные ссылки основаны на ключах; Система создаст ссылку, если ключ еще не взят и обновит ссылку, если она найдена.

Известные проблемы и ограничения

  • Соединитель поддерживает только ключевые элементы для ссылок при создании и редактировании. Теги и сведения о маркетинге не включены (для управления ими используйте приложение администрирования напрямую).
  • Домены, теги и отчеты в настоящее время не поддерживаются в рамках этого соединителя.

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

Соединитель поддерживает следующие типы проверки подлинности:

По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

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

Имя Тип Description Обязательно
Ключ API securestring Ключ API для этого API True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Обновление ссылки по идентификатору

Обновите существующую короткую ссылку указанным идентификатором.

Получение всех доменов

Получите все домены, доступные для вашей учетной записи.

Получение ссылок

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

Создание предопределенной ссылки

Создайте предопределенную ссылку в короткой ссылке для заданного ключа.

Создание ссылки

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

Удалить предопределенную ссылку

Удалите существующую предопределенную ссылку на основе идентификатора ссылки и ключа.

Удалить ссылку

Удалите указанную короткую ссылку по предоставленному идентификатору.

Обновление ссылки по идентификатору

Обновите существующую короткую ссылку указанным идентификатором.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор
id True integer

Идентификатор обновляемой ссылки.

Идентификатор пользователя SBR
X-SBR-UserID True integer

Идентификатор учетной записи пользователя, используемый для проверки.

Ключ токена SBR
X-SBR-TokenKey True string

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

Кэш
cache True boolean

cache

Идентификатор домена
domain_id True integer

Идентификатор связанного домена.

Имя
name True string

Понятное имя ссылки.

Путь
path True string

Путь к ссылке, используемой для перенаправления.

Перенаправить
redirect True string

Результат перенаправления для ссылки при посещении пользователем.

Состояние
status True string

Состояние ссылки.

Возвращаемое значение

Имя Путь Тип Описание
данные
data array of object

данные

Идентификатор
data.id integer

Идентификатор ссылки.

Имя
data.name string

Понятное имя ссылки.

Тип
data.type string

Тип ссылки.

Путь
data.path string

Путь к ссылке, используемой для перенаправления.

Перенаправить
data.redirect string

Результат перенаправления для ссылки при посещении пользователем.

Состояние
data.status string

Состояние ссылки.

Состояние здоровья
data.health_status string

Текущее состояние работоспособности ссылки.

Кэш
data.cache boolean

Логическое значение для включения или отключения кэширования для данной ссылки.

Работоспособность последняя проверка
data.health_checked_at string

Дата и время проверки состояния работоспособности ссылки.

Идентификатор домена
data.domain_id integer

Идентификатор связанного домена.

Созданный URL-адрес
data.generated_url string

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

Идентификатор домена
data.domain.id integer

Уникальный идентификатор домена.

Имя домена
data.domain.name string

Понятное имя домена.

URL-адрес домена
data.domain.url string

URL-адрес домена.

Состояние домена
data.domain.status string

Состояние домена.

Область домена
data.domain.scope string

Уровень области системы для домена.

URL-адрес корневого адреса по умолчанию
data.domain.default_root_url string

Корневой URL-адрес по умолчанию, используемый доменом.

URL-адрес Catchall по умолчанию
data.domain.default_catchall_url string

URL-адрес Catchall по умолчанию, используемый доменом.

Итог результатов
meta.total integer

Общее количество доменов в результирующем наборе независимо от разбиения по страницам.

Численность
meta.count integer

Общее количество доменов, доступных для текущей страницы.

Страница результатов
meta.page integer

Текущая страница результирующий набор.

Общие результаты страниц
meta.pages integer

Общие страницы, доступные на основе per_page и общих параметров.

Результаты на страницу
meta.per_page integer

Количество доменов, возвращаемых для данной страницы.

Упорядочивание результатов
meta.order string

Поле, на основе порядка.

Сортировка результатов
meta.sort string

Направление сортировки, используемое в сочетании с параметром заказа.

Получение всех доменов

Получите все домены, доступные для вашей учетной записи.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя SBR
X-SBR-UserID True integer

Идентификатор учетной записи пользователя, используемый для проверки.

Ключ токена SBR
X-SBR-TokenKey True string

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

Возвращаемое значение

Имя Путь Тип Описание
данные
data array of object

данные

Идентификатор
data.id integer

Уникальный идентификатор домена.

Имя
data.name string

Уникальное имя домена.

URL
data.url string

URL-адрес домена.

Состояние
data.status string

Состояние домена.

Scope
data.scope string

Уровень области системы для домена.

URL-адрес корневого адреса по умолчанию
data.default_root_url string

URL-адрес корневого каталога по умолчанию для домена.

URL-адрес Catchall по умолчанию
data.default_catchall_url string

URL-адрес Catchall по умолчанию для домена.

Итог результатов
meta.total integer

Общее количество доменов в результирующем наборе независимо от разбиения по страницам.

Численность
meta.count integer

Общее количество доменов, доступных для текущей страницы.

Страница результатов
meta.page integer

Текущая страница результирующий набор.

Общие результаты страниц
meta.pages integer

Общие страницы, доступные на основе per_page и общих параметров.

Результаты на страницу
meta.per_page integer

Количество доменов, возвращаемых для данной страницы.

Упорядочивание результатов
meta.order string

Поле, на основе порядка.

Сортировка результатов
meta.sort string

Направление сортировки, используемое в сочетании с параметром заказа.

Получение ссылок

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя SBR
X-SBR-UserID True integer

Идентификатор учетной записи пользователя, используемый для проверки.

Ключ токена SBR
X-SBR-TokenKey True string

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

Типы
search_types True string

Разделенный запятыми список типов для поиска. Types:

  • default - Стандартные короткие ссылки
  • predefined — предопределенные короткие ссылки
  • trackable_chat — отслеживаемые короткие ссылки из SeeBotChat
  • trackable_text — отслеживаемые короткие ссылки из SeeBotText
Идентификатор домена
domain_id True integer

Идентификатор домена для возврата ссылок.

Возвращаемое значение

Имя Путь Тип Описание
данные
data array of object

данные

Идентификатор
data.id integer

Идентификатор ссылки.

Имя
data.name string

Понятное имя ссылки.

Тип
data.type string

Тип ссылки.

Путь
data.path string

Путь к ссылке, используемой для перенаправления.

Перенаправить
data.redirect string

Результат перенаправления для ссылки при посещении пользователем.

Состояние
data.status string

Состояние ссылки.

Состояние здоровья
data.health_status string

Текущее состояние работоспособности ссылки.

Кэш
data.cache boolean

Логическое значение для включения или отключения кэширования для данной ссылки.

Работоспособность последняя проверка
data.health_checked_at string

Дата и время проверки состояния работоспособности ссылки.

Идентификатор домена
data.domain_id integer

Идентификатор связанного домена.

Созданный URL-адрес
data.generated_url string

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

Идентификатор домена
data.domain.id integer

Уникальный идентификатор домена.

Имя домена
data.domain.name string

Понятное имя домена.

URL-адрес домена
data.domain.url string

URL-адрес домена.

Состояние домена
data.domain.status string

Состояние домена.

Область домена
data.domain.scope string

Уровень области системы для домена.

URL-адрес корневого адреса по умолчанию
data.domain.default_root_url string

Корневой URL-адрес по умолчанию, используемый доменом.

URL-адрес Catchall по умолчанию
data.domain.default_catchall_url string

URL-адрес Catchall по умолчанию, используемый доменом.

Итог результатов
meta.total integer

Общее количество ссылок в результирующем наборе независимо от разбиения по страницам.

Численность
meta.count integer

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

Страница результатов
meta.page integer

Текущая страница результирующий набор.

Общие результаты страниц
meta.pages integer

Общие страницы, доступные на основе per_page и общих параметров.

Результаты на страницу
meta.per_page integer

Количество ссылок, возвращаемых для данной страницы.

Упорядочивание результатов
meta.order string

Поле, на основе порядка.

Сортировка результатов
meta.sort string

Направление сортировки, используемое в сочетании с параметром заказа.

Создание предопределенной ссылки

Создайте предопределенную ссылку в короткой ссылке для заданного ключа.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор ссылки
id True integer

Идентификатор ссылки предопределенной ссылки, создаваемой или обновляемой.

Key
key True string

Ключ предопределенной ссылки, создаваемой или обновленной.

Идентификатор пользователя SBR
X-SBR-UserID True integer

Идентификатор учетной записи пользователя, используемый для проверки.

Ключ токена SBR
X-SBR-TokenKey True string

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

Путь
path True string

Путь к предопределенной ссылке.

Перенаправить
redirect True string

Перенаправление для предопределенной ссылки.

Примечания.
notes string

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

Возвращаемое значение

Имя Путь Тип Описание
Идентификатор
id integer

Уникальный идентификатор предопределенной ссылки.

Key
key string

Уникальный ключ для предопределенной ссылки.

Путь
path string

Путь, используемый в созданном перенаправлении для предопределенной ссылки.

Перенаправить
redirect string

Перенаправление, используемое при посещении предварительно определенной ссылки.

Примечания.
notes string

Внутренние заметки, используемые администраторами для предопределенной ссылки.

Созданный URL-адрес
generated_url string

Созданный короткий URL-адрес для предопределенной ссылки

Идентификатор ссылки
link_id integer

Связанный идентификатор ссылки для предопределенной ссылки.

Идентификатор клиента
client_id integer

Связанный идентификатор клиента для предопределенной ссылки.

Создано в
created_at string

Дата и время создания предопределенной ссылки.

Обновлено в
updated_at string

Дата и время последнего обновления предопределенной ссылки.

Создание ссылки

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

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор пользователя SBR
X-SBR-UserID True integer

Идентификатор учетной записи пользователя, используемый для проверки.

Ключ токена SBR
X-SBR-TokenKey True string

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

Кэш
cache True boolean

Логическое значение для включения или отключения кэширования для данной ссылки.

Идентификатор домена
domain_id True integer

Идентификатор связанного домена.

Имя
name True string

Понятное имя ссылки.

Путь
path True string

Путь к ссылке, используемой для перенаправления.

Перенаправить
redirect True string

Результат перенаправления для ссылки при посещении пользователем.

Состояние
status True string

Состояние ссылки.

Тип
type True string

Тип ссылки.

Возвращаемое значение

Имя Путь Тип Описание
данные
data array of object

данные

Идентификатор
data.id integer

Идентификатор ссылки.

Имя
data.name string

Понятное имя ссылки.

Тип
data.type string

Тип ссылки.

Путь
data.path string

Путь к ссылке, используемой для перенаправления.

Перенаправить
data.redirect string

Результат перенаправления для ссылки при посещении пользователем.

Состояние
data.status string

Состояние ссылки.

Состояние здоровья
data.health_status string

Текущее состояние работоспособности ссылки.

Кэш
data.cache boolean

Логическое значение для включения или отключения кэширования для данной ссылки.

Работоспособность последняя проверка
data.health_checked_at string

Дата и время проверки состояния работоспособности ссылки.

Идентификатор домена
data.domain_id integer

Идентификатор связанного домена.

Созданный URL-адрес
data.generated_url string

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

Идентификатор домена
data.domain.id integer

Уникальный идентификатор домена.

Имя домена
data.domain.name string

Понятное имя домена.

URL-адрес домена
data.domain.url string

URL-адрес домена.

Состояние домена
data.domain.status string

Состояние домена.

Область домена
data.domain.scope string

Уровень области системы для домена.

URL-адрес корневого адреса по умолчанию
data.domain.default_root_url string

Корневой URL-адрес по умолчанию, используемый доменом.

URL-адрес Catchall по умолчанию
data.domain.default_catchall_url string

URL-адрес Catchall по умолчанию, используемый доменом.

Итог результатов
meta.total integer

Общее количество доменов в результирующем наборе независимо от разбиения по страницам.

Численность
meta.count integer

Общее количество доменов, доступных для текущей страницы.

Страница результатов
meta.page integer

Текущая страница результирующий набор.

Общие результаты страниц
meta.pages integer

Общие страницы, доступные на основе per_page и общих параметров.

Результаты на страницу
meta.per_page integer

Количество доменов, возвращаемых для данной страницы.

Упорядочивание результатов
meta.order string

Поле, на основе порядка.

Сортировка результатов
meta.sort string

Направление сортировки, используемое в сочетании с параметром заказа.

Удалить предопределенную ссылку

Удалите существующую предопределенную ссылку на основе идентификатора ссылки и ключа.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор ссылки
id True integer

Идентификатор ссылки для предопределенной ссылки, удаляемой.

Key
key True string

Уникальный ключ для предопределенной ссылки, удаляемой.

Идентификатор пользователя SBR
X-SBR-UserID True integer

Идентификатор учетной записи пользователя, используемый для проверки.

Ключ токена SBR
X-SBR-TokenKey True string

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

Удалить ссылку

Удалите указанную короткую ссылку по предоставленному идентификатору.

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор
id True integer

Идентификатор удаленной ссылки.

Идентификатор пользователя SBR
X-SBR-UserID True integer

Идентификатор учетной записи пользователя, используемый для проверки.

Ключ токена SBR
X-SBR-TokenKey True string

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