Токены доступа

Токены доступа могут использоваться для доступа к API Спекл. Они функционируют как обычные токены доступа OAuth и позволяют скрипту, приложению или любому другому фрагменту кода действовать от вашего имени.

Это означает, что с помощью токена приложение или скрипт может:

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

Токен доступа очень похож на пароль: не размещайте их в местах, где к ним могут получить доступ другие лица (например, в публичных репозиториях)

Создание токена

Сначала вам нужно перейдите в "Настройки". Вменю справа выберите "Разработка". Перейдя в раздел, Вы увидите список всех токенов доступа, которые вы создали ранее, и сможете создать новый.

Чтобы создать новый токен, нажмите кнопку «Новый токен». Появится диалоговое окно, в котором вас попросят ввести некоторые данные. Области применения токена определяют, какие действия можно выполнить, используя этот токен.

После нажатия кнопки "Создать" на экране появится токен. Это первый и последний раз, когда вы сможете увидеть его в системе, поэтому Вам нужно скопировать и сохранить его в безопасном месте.

Использование токена

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

Например, простой запрос для получения общего количества ваших проектов с помощью JavaScript:

let res = await fetch('/graphql', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer ' + token  // <- Вставьте токен
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ query: `{ user { id projects { totalCount } } }` })
})

Обратите внимание, что токен должен иметь префикс Bearer

Отзыв токена

Если вы больше не используете токен или считаете, что он может быть скомпрометирован, вы можете отозвать токен. Он будет полностью отключен, и с его помощью больше нельзя будет выполнять никаких действий.

Apps