Введение | Revroute Docs

Ссылки — это основа Revroute .

Всё в Revroute начинается со ссылки. Будь то:

несколько ссылок для вашей маркетинговой кампании
сотни ссылок для вашей партнёрской программы
тысячи ссылок, программно, для вашей SMS-кампании

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

Модель ссылки

Модель ссылки включает следующие свойства:

Property	Description	Example
`id`	The unique identifier of the link (prefixed with `link_`)	`link_1KJ1H3PZGE081A22TC6PTQYJP`
`url`	The destination URL of the link	`https://revroute.ru/`
`shortLink`	The shortened version of the link (including https)	`https://dub.link/claim`
`domain`	The domain of the link	`dub.link`
`key`	The short link slug	`claim`

Для более продвинутых функций, таких как пользовательские превью ссылок, отслеживание конверсий и другие, см. полный список свойств здесь.

Вы можете использовать различные SDK Revroute для программного управления ссылками.

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

Поле url, представляющее целевой URL, является единственным обязательным параметром для создания новой короткой ссылки.


import { Revroute } from "dub";
 
export const dub = new Revroute({
  token: process.env.DUB_API_KEY,
});
 
const link = await dub.links.create({
  url: "https://google.com",
});

Ознакомьтесь с полным справочником API для эндпоинта создания ссылок.

Обновление ссылки

Существующую ссылку можно обновить, передав id в метод update. Этот метод возвращает обновлённую ссылку в ответе.

Вы можете использовать либо linkId, либо externalId с префиксом ext_, который является уникальным идентификатором ссылки в вашей базе данных для связи с ссылкой в системе Revroute.


import { Revroute } from "dub";
 
export const dub = new Revroute({
  token: process.env.DUB_API_KEY,
});
 
const link = await dub.links.update("link_1KJ1H3PZGE081A22TC6PTQYJP", {
  url: "https://www.google.uk", // new URL
});

Ознакомьтесь с полным справочником API для эндпоинта обновления ссылок.

Upsert ссылки

Операция upsert ссылки — это комбинация создания и обновления. Если ссылка с таким же URL уже существует, она будет возвращена (или обновлена при наличии изменений). В противном случае будет создана новая ссылка.

Это позволяет использовать метод upsert без необходимости предварительной проверки существования ссылки.


import { Revroute } from "dub";
 
export const dub = new Revroute({
  token: process.env.DUB_API_KEY,
});
 
const link = await dub.links.upsert({
  url: "https://google.com", // will always be the same short link
});

Ознакомьтесь с полным справочником API для эндпоинта upsert ссылок.