Авторизация

Краткий обзор

Узнайте, как авторизовать запросы к Octopart API с помощью OAuth 2.0: от поиска учетных данных приложения до получения и использования токена доступа. В этом руководстве рассматриваются взаимодействие между приложениями (machine-to-machine), срок действия токенов и ротация Client Secret, а примеры запросов помогут разобраться на практике. Читайте дальше, чтобы подготовить приложение к отправке авторизованных запросов к API.

- Найдите Client ID и Client Secret и обменяйте их на токен доступа.
- Добавляйте токен в запросы GraphQL и обрабатывайте истечение срока его действия.
- Выполняйте ротацию Client Secret и узнайте, как защитить учетные данные.
Узнайте больше с ИИ:

Octopart API использует OAuth 2.0 с типом предоставления доступа client_credentials — это схема межмашинного взаимодействия, не требующая входа пользователя в систему. Ваше приложение обменивает Client ID и Client Secret на короткоживущий токен доступа, а затем включает этот токен в каждый запрос к API.

Получение учетных данных

Управление учетными данными осуществляется на портале разработчика:

  1. Войдите на portal.nexar.com.

  2. Откройте свое приложение (или создайте новое).

  3. Скопируйте Client ID и Client Secret.

Your Client Secret is shown once at creation time. Если вы его потеряете, потребуется сгенерировать новый — портал не сможет показать его повторно.

Запрос токена доступа

Отправьте POST-запрос на конечную точку выдачи токенов, указав свои учетные данные:

curl -X POST https://identity.nexar.com/connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=CLIENT_ID" \
  -d "client_secret=CLIENT_SECRET" \
  -d "scope=supply.domain"

Параметр

Значение

grant_type

client_credentials

client_id

Client ID вашего приложения

client_secret

Client Secret вашего приложения

scope

supply.domain

Успешный ответ:

{
  "access_token": "eyJhbGci...",
  "expires_in": 86400,
  "token_type": "Bearer"
}

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

Включайте токен доступа в заголовок Authorization каждого GraphQL-запроса:

Authorization: Bearer ACCESS_TOKEN

Пример:

curl -X POST https://api.nexar.com/graphql \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "query": "{ supSearchMpn(q: \"LM358\", limit: 1) { hits } }" }'

Запросы без действительного токена или с просроченным токеном вернут ответ HTTP 401 Unauthorized.

Срок действия токена

Срок действия токенов истекает через 24 hours (expires_in: 86400). Ваше приложение должно отслеживать срок действия и запрашивать новый токен до истечения срока действия текущего. В схеме client_credentials токен обновления не предусмотрен — чтобы получить новый токен доступа, просто повторите запрос с вашими Client ID и Client Secret.

Распространенный подход — запрашивать новый токен при запуске приложения и затем каждый раз при получении ответа 401.

Смена Client Secret

Если ваш Client Secret скомпрометирован или вы хотите сменить его в целях безопасности:

  1. Перейдите к своему приложению на portal.nexar.com.

  2. Сгенерируйте новый Client Secret.

  3. Обновите Client Secret в своем приложении.

  4. Существующие токены остаются действительными до истечения срока действия — их работа не прервется сразу после смены секрета.

Do not embed credentials in client-side code or public repositories. Обращайтесь с Client Secret как с паролем.

 

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Contents
Contents