Отзывайте и проверяйте токены OAuth

Отозвать токен#

curl --fail-with-body https://auth.shareai.now/oauth/revoke \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
  --data-urlencode "client_secret=$SHAREAI_CLIENT_SECRET" \
  --data-urlencode "token=$SHAREAI_ACCESS_TOKEN"

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

Проверить активность#

curl --fail-with-body https://auth.shareai.now/oauth/introspect \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
  --data-urlencode "client_secret=$SHAREAI_CLIENT_SECRET" \
  --data-urlencode "token=$SHAREAI_ACCESS_TOKEN"

Проверить active перед использованием других возвращенных полей. Интроспекция описывает состояние токена на момент проверки; авторизация API все еще применяется, когда последующий запрос принимается. Токен от другого клиента не должен рассматриваться как авторизация вашего приложения.

Подключиться заново, когда требуется согласие#

Отозванная или истекшая авторизация может потребовать новой авторизации через браузер. Держите этот процесс отдельно от временной 503 ошибки сервиса. Повторное обновление недействительного токена не восстанавливает согласие клиента.