• Руководство пользователя
    • Заметки о безопасности
      Заметки о безопасности
    • Online/Desktop приложения
      • Управление аккаунтом
        • Создать аккаунт
          Создать аккаунт
        • Войти в аккаунт
          Войти в аккаунт
        • Создать Резервную Копию Seed-фразы
          Создать Резервную Копию Seed-фразы
        • Восстановить аккаунт
          Восстановить аккаунт
        • Узнать свой адрес Waves.Exchange
          Узнать свой адрес Waves.Exchange
        • Создать персональный алиас
          Создать персональный алиас
        • Импорт из Waves Keeper
          Импорт из Waves Keeper
        • Использовать устройства Legder Nano
          Использовать устройства Legder Nano
        Управление аккаунтом
      • Управление ассетами
        • Перевести криптовалюту
          • Транзакции
            Транзакции
          Перевести криптовалюту
        • Купить криптовалюту с помощью банковской карты
          • Как работать с платежной системой Advanced Cash
            Как работать с платежной системой Advanced Cash
          Купить криптовалюту с помощью банковской карты
        • Передать в стейкинг
          • Услуга OTC
            Услуга OTC
          • Своп WAVES/USDN
            Своп WAVES/USDN
          • Как получить USDN (Quick Guide)
            Как получить USDN (Quick Guide)
          • Как получить USDT/USDC/BTC/ETH (Quick Guide)
            Как получить USDT/USDC/BTC/ETH (Quick Guide)
          Передать в стейкинг
        • Lambo инвестиции
          Lambo инвестиции
        • Алгоритмическая торговля
          Алгоритмическая торговля
        • Управление Neutrino
          Управление Neutrino
        • Neutrino пулы
          Neutrino пулы
        • Своп DeFo
          Своп DeFo
        • Создать ассет
          Создать ассет
        • Разослать ассет
          Разослать ассет
        • Перевыпустить ассет
          Перевыпустить ассет
        • Поменять перевыпускаемый на не перевыпускаемый
          Поменять перевыпускаемый на не перевыпускаемый
        • Сжечь ассет
          Сжечь ассет
        • Спонсорская транзакция
          Спонсорская транзакция
        • Спонсорская комиссия
          Спонсорская комиссия
        Управление ассетами
      • Расширенные возможности
        • Script транзакции
          Script транзакции
        • JSON подтверждение
          JSON подтверждение
        Расширенные возможности
      • Торговля на бирже
        Торговля на бирже
      • Левередж
        Левередж
      Online/Desktop приложения
    • Мобильные приложения
      • Управление аккаунтом
        • Создать аккаунт
          Создать аккаунт
        • Войти в аккаунт
          Войти в аккаунт
        • Восстановить аккаунт
          Восстановить аккаунт
        • Узнать свой адрес Waves.Exchange
          Узнать свой адрес Waves.Exchange
        • Создать персональный алиас
          Создать персональный алиас
        Управление аккаунтом
      • Управление ассетами
        • Перевести криптовалюту
          Перевести криптовалюту
        • Купить криптовалюту с помощью банковской карты
          Купить криптовалюту с помощью банковской карты
        • Передать WAVES в стейкинг
          Передать WAVES в стейкинг
        • Передать USDN в стейкинг
          Передать USDN в стейкинг
        • Сжечь ассет
          Сжечь ассет
        Управление ассетами
      • Торговля на бирже
        Торговля на бирже
      Мобильные приложения
    Руководство пользователя
  • API и библиотека
    • CCXT
      CCXT
    • Комиссии
      Комиссии
    • API платежей
      API платежей
    • API авторизации
      API авторизации
    • API шлюза
      • Токен доступа
        • Получить токен в интерфейсе
          Получить токен в интерфейсе
        • POST /v1/oauth2/token
          POST /v1/oauth2/token
        Токен доступа
      • Внесение средств
        • GET /v1/deposit/addresses/{currency}
          GET /v1/deposit/addresses/{currency}
        • GET /v1/deposit/currencies
          GET /v1/deposit/currencies
        • GET /v1/deposit/currencies/{currency}
          GET /v1/deposit/currencies/{currency}
        • Terms of Deposit
          Terms of Deposit
        Внесение средств
      • Вывод средств
        • GET /v1/withdraw/addresses/{currency}/{address}
          GET /v1/withdraw/addresses/{currency}/{address}
        • GET /v1/withdraw/currencies
          GET /v1/withdraw/currencies
        • GET /v1/withdraw/currencies/{currency}
          GET /v1/withdraw/currencies/{currency}
        • Условия вывода
          Условия вывода
        Вывод средств
      • История операций
        История операций
      • Список платформ
        Список платформ
      • Проверка соответствия балансов
        Проверка соответствия балансов
      • Коды ошибок
        Коды ошибок
      API шлюза
    • Матчер
      • Протокол Waves.Exchange
        Протокол Waves.Exchange
      • Комиссия матчера
        Комиссия матчера
      • Установка матчера на Ubuntu из Deb-пакета
        Установка матчера на Ubuntu из Deb-пакета
      • Настройки матчера
        Настройки матчера
      • API Матчера
        • Правила валидации ордера
          Правила валидации ордера
        • Правила валидации ExchangeTransaction
          Правила валидации ExchangeTransaction
        API Матчера
      Матчер
    API и библиотека
  • Глоссарий
    Глоссарий
      • English
      • Русский
      On this page
        • Первоначальное получение токена
          • Параметры запроса
          • Пример ответа
          • Параметры ответа
          • Пример JavaScript
        • Перевыпуск токена доступа
          • Параметры запроса
          • Пример ответа
          • Пример JavaScript

          # POST /v1/oauth2/token

          Возвращает токен доступа и токен обновления.

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

          В запросе необходимо указать HTTP-заголовок Content-type: application/x-www-form-urlencoded.

          # Первоначальное получение токена

          POST /v1/oauth2/token
          Content-type: application/x-www-form-urlencoded
          
          {
            "grant_type": "password",
            "scope": "general",
            "username": "(string)",
            "password" "(string)",
            "client_id": "waves.exchange"
          }
          

          # Параметры запроса

          Имя параметра Описание
          grant_type Для получения токена в первый раз укажите password
          scope Укажите general
          username Публичный ключ пользователя (opens new window)
          password Сгенерируйте пароль следующим образом:
          1. Объедините символ chain ID (opens new window) со строкой client_id и с Unix-временем окончания срока действия токена (в секундах), используя разделитель ':'. Например, W:waves.exchange:1584651600.
          2. Преобразуйте полученную строку в последовательность байтов.
          3. Добавьте префикс [255, 255, 255, 1].
          Сгенерируйте Curve25519 (opens new window)-подпись байтов, используя приватный ключ (opens new window) пользователя.
          4. Объедините Unix-время окончания срока действия токена в секундах с подписью в кодировке base58, используя разделитель ':'. Например, 1584651600:3BU36da1h6Bzhs4tKcfkCsXWi4vEgP8eQD7rkGWJdxbRfNpky6p3p7mUJWEL9ejDsasS8nWu1g6tZpsX4.
          ⚠️ Срок действия токена не должен превышать неделю.
          См. также подраздел Пример JavaScript ниже.
          client_id Для Gateway API укажите waves.exchange

          # Пример ответа

          {
            "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzaWduYXR1cmUiOiI2MUppRFBQWUZya2pw...",
            "token_type": "bearer",
            "expires_in": 1584651600,
            "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzaWduYXR1cmUiOiI2MUppRFBQWUZya2pw..."
          }
          

          # Параметры ответа

          Имя параметра Описание
          access_token Токен доступа для использования в запросах к API
          token_type Тип токена, всегда bearer
          expires_in Время окончания срока действия токена: Unix-время в секундах
          refresh_token Токен обновления. После истечения срока действия токена доступа вы можете перевыпустить токен доступа с помощью токена обновления, см. подраздел Перевыпуск токена доступа ниже. Срок действия токена обновления по умолчанию 1 месяц.

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

          # Пример JavaScript

          В этом примере используется библиотека waves-transactions. См. документацию библиотеки (opens new window) на Github.

          import { libs } from "@waves/waves-transactions";
          
          const seed = "insert your seed here";
          const chain_code = "W"; // "T" для Testnet
          const client_id = "waves.exchange";
          const seconds = Math.round((Date.now() + 1000 * 60 * 60 * 24 * 7) / 1000); // Токен на неделю
          
          const bytes = [255, 255, 255, 1, ...libs.crypto.stringToBytes(`${chain_code}:${client_id}:${seconds}`)];
          const signature = libs.crypto.signBytes(seed, bytes);            
          
          fetch('https://api.waves.exchange/v1/oauth2/token', {
              method: 'POST',
              headers: {
                  'Content-type': 'application/x-www-form-urlencoded'
              },
              body: [
                  "grant_type=password",
                  "scope=general",
                  `username=${encodeURIComponent(libs.crypto.publicKey(seed))}`,
                  "password=" + encodeURIComponent(`${seconds}:${signature}`),
                  `client_id=${client_id}`
              ].join('&')
          });
          

          # Перевыпуск токена доступа

          POST /v1/oauth2/token
          Content-type: application/x-www-form-urlencoded
          
          {
            "grant_type": "refresh_token",
            "scope": "general",
            "client_id": "waves.exchange",
            "refresh_token": "(string)"
          }
          

          # Параметры запроса

          Имя параметра Описание
          grant_type Для обмена токена обновления на токен доступа укажите refresh_token
          scope Укажите general
          client_id Для Gateway API укажите waves.exchange
          refresh_token Токен обновления. После истечения срока действия токена доступа вы можете обменять токен обновления на новый токен доступа

          # Пример ответа

          {
            "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzaWduYXR1cmUiOiI2MUppRFBQWUZya2pw...",
            "token_type": "bearer",
            "expires_in": 1584109637,
            "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzaWduYXR1cmUiOiI2MUppRFBQWUZya2pw..."
          }
          

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

          # Пример JavaScript

          const refresh_token = "insert your refresh token here";
          const client_id = "waves.exchange";
          
          fetch('https://api.waves.exchange/v1/oauth2/token', {
              method: 'POST',
              headers: {
                  'Content-type': 'application/x-www-form-urlencoded'
              },
              body: [
                  "grant_type=refresh_token",
                  "scope=general",
                  `refresh_token=${refresh_token}`,
                  `client_id=${client_id}`
              ].join('&')
          });
          
          Получить токен в интерфейсе
          Внесение средств
          Получить токен в интерфейсе
          Внесение средств