Маршрутизация и таргетинг
Подресурсы платформы, условий, целей и свойств (пароль, срок действия, лимит, UTM, задержка).
Маршруты определяют, какой посетитель на какую цель попадёт. При выборе используются поля targeting, deviceProfileIds, priority, sortOrder, isActive и isGlobalFallback.
Платформа и условия#
- platform:
GLOBAL,DEVICE,BROWSER,OS,GEO,LANGUAGE - тип условия:
COUNTRY,DEVICE_PROFILE,OS,USER_AGENT,LANGUAGE,REFERRER_DOMAIN - оператор:
IN,NOT_IN,EQUALS,REGEX - цель: активные элементы каталога платформ; цели маршрута привязываются через
itemId
Каталог платформ можно прочитать через GET /api/v1/links/platform-catalog; в публичном API каталог доступен только для чтения.
Свойства#
Типы свойств маршрута: PASSWORD, EXPIRATION_DATE, LIMIT, UTM и REDIRECT_DELAY. Свойства действуют на уровне ссылки или маршрута и управляются флагом enabled и JSON-полем config.
Подресурсы#
| Метод | Путь | Scope |
|---|---|---|
| GET / POST | /api/v1/links/:id/routes | links:read / links:write |
| PATCH / DELETE | /api/v1/links/:id/routes/:routeId | links:write / links:delete |
| GET / POST | …/routes/:routeId/conditions | links:read / links:write |
| GET / POST | …/routes/:routeId/targets | links:read / links:write |
| GET / POST | …/routes/:routeId/features | links:read / links:write |
Для каждого подресурса PATCH и DELETE также поддерживаются по путям …/:conditionId, …/:itemId и …/:featureId с теми же правилами scope.
Чего-то не хватает или есть ошибка? Напишите в поддержку; приложив значение X-Request-Id из ответа, вы ускорите решение.