Авторизация
Краткий обзор
- Найдите Client ID и Client Secret и обменяйте их на токен доступа.
- Добавляйте токен в запросы GraphQL и обрабатывайте истечение срока его действия.
- Выполняйте ротацию Client Secret и узнайте, как защитить учетные данные.
Octopart API использует OAuth 2.0 с типом предоставления доступа client_credentials — это схема межмашинного взаимодействия, не требующая входа пользователя в систему. Ваше приложение обменивает Client ID и Client Secret на короткоживущий токен доступа, а затем включает этот токен в каждый запрос к API.
Получение учетных данных
Управление учетными данными осуществляется на портале разработчика:
-
Войдите на portal.nexar.com.
-
Откройте свое приложение (или создайте новое).
-
Скопируйте Client ID и Client Secret.
Запрос токена доступа
Отправьте 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"
Параметр |
Значение |
|
|
|
Client ID вашего приложения |
|
Client Secret вашего приложения |
|
|
Успешный ответ:
{
"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 скомпрометирован или вы хотите сменить его в целях безопасности:
-
Перейдите к своему приложению на portal.nexar.com.
-
Сгенерируйте новый Client Secret.
-
Обновите Client Secret в своем приложении.
-
Существующие токены остаются действительными до истечения срока действия — их работа не прервется сразу после смены секрета.