Эндпоинты OAuth (/oauth/authorize, /oauth/token, /oauth/userinfo) не доступны в SDK Revroute. Вам потребуется вызывать эти эндпоинты напрямую через HTTP-запросы или клиентскую библиотеку OAuth.

• Перейдите на вкладку OAuth Apps  в вашем рабочем пространстве.
• Нажмите Create OAuth App.
• Заполните необходимые поля для создания OAuth2-приложения.

Когда вы хотите аутентифицировать пользователя, необходимо перенаправить его на URL авторизации Revroute OAuth.

GET https://app.revroute.ru/oauth/authorize

Параметры:

Пример URL:

GET https://app.revroute.ru/oauth/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code&scope=SOME_SCOPE&state=SOME_STATE&code_challenge=YOUR_CODE_CHALLENGE&code_challenge_method=S256

Параметр code возвращается в строке запроса при перенаправлении пользователя обратно в ваше приложение. Вы можете обменять этот код на токен доступа, отправив POST-запрос на URL токена Revroute OAuth.

POST https://api.dub.co/oauth/token

await fetch("https://api.dub.co/oauth/token", {
  method: "POST",
  headers: {
    "Content-Type": "application/x-www-form-urlencoded",
  },
  body: new URLSearchParams({
    code: "YOUR_AUTHORIZATION_CODE",
    client_id: "YOUR_CLIENT_ID",
    code_verifier: "YOUR_CODE_VERIFIER",
    redirect_uri: "YOUR_REDIRECT_URI",
    grant_type: "authorization_code",
  }),
});

Ответ:

После успешного запроса вы получите JSON-ответ с токеном доступа.

{
  "access_token": "dub_access_token_ae8ebf6f97e6200d886ef48a5...",
  "refresh_token": "7f5acfbe14bca0a20fe6e430ddb7bb494eed160bd...",
  "token_type": "Bearer",
  "expires_in": 7200,
  "scope": "links.write tags.write domains.read"
}

После получения токена доступа вы можете получить информацию об аутентифицированном пользователе и его рабочем пространстве, вызвав эндпоинт userinfo:

GET https://api.dub.co/oauth/userinfo

Пример с использованием curl:

curl --request GET \
  --url https://api.dub.co/oauth/userinfo \
  --header 'Authorization: Bearer <ACCESS_TOKEN>'

Ответ:

{
  "id": "user_id",
  "name": "John Doe",
  "image": "https://example.com/avatar.png",
  "workspace": {
    "id": "ws_abc123",
    "slug": "acme",
    "name": "Acme Inc",
    "logo": "https://example.com/logo.png"
  }
}

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

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

Вот пример создания ссылки с помощью TypeScript SDK Revroute:

import { Revroute } from "dub";
 
const dub = new Revroute({
  token: <ACCESS_TOKEN>,
});
 
const link = await dub.links.create({
  url: "https://google.com",
});

Или передайте токен доступа в заголовке: Authorization: Bearer <ACCESS_TOKEN>

  curl --request POST \
  --url https://api.dub.co/links \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Content-Type: application/json'

Токены доступа Revroute являются краткосрочными, в зависимости от значения expires_in (значение по умолчанию — 7 200 секунд, или 2 часа). Revroute вернёт ответ 401 Unauthorized, если вы попытаетесь использовать просроченный токен доступа.

Для обновления токена доступа необходимо отправить POST-запрос на URL токена Revroute OAuth с refresh_token, полученным при обмене кода на access_token.

POST https://api.dub.co/oauth/token

Параметры:

Ответ:

После успешного запроса вы получите JSON-ответ с новым токеном доступа.

{
  "access_token": "dub_access_token_ae8ebf6f97e6200d886ef48a5...",
  "refresh_token": "7f5acfbe14bca0a20fe6e430ddb7bb494eed160bd...",
  "token_type": "Bearer",
  "expires_in": 7200,
  "scope": "links.write tags.write domains.read"
}

Это аннулирует старый токен доступа и токен обновления.