Перейти к содержимому

Authorization Code + PKCE flow

Этот гайд проведёт вас через полный Authorization Code + PKCE flow: от генерации PKCE-пары до обновления и отзыва токенов.

Сгенерируйте code_verifier (случайная строка 43–128 символов) и code_challenge (SHA-256 от verifier, base64url без padding).

Окно терминала
# Генерация code_verifier (43 случайных байта → base64url)
CODE_VERIFIER=$(openssl rand -base64 32 | tr '+/' '-_' | tr -d '=')
# Генерация code_challenge (SHA-256 → base64url)
CODE_CHALLENGE=$(echo -n "$CODE_VERIFIER" | openssl dgst -sha256 -binary | openssl base64 | tr '+/' '-_' | tr -d '=')
echo "code_verifier=$CODE_VERIFIER"
echo "code_challenge=$CODE_CHALLENGE"

Перенаправьте пользователя на endpoint авторизации:

GET https://api.flowworker.ru/oauth/authorize
?client_id=YOUR_CLIENT_ID
&response_type=code
&redirect_uri=https://yourapp.example.com/callback
&scope=tasks:read tasks:write
&code_challenge=CODE_CHALLENGE
&code_challenge_method=S256
&state=RANDOM_STATE

Пользователь видит экран логина (если не авторизован), выбирает аккаунт FlowWorker и подтверждает запрошенные разрешения (consent). После согласия FlowWorker делает 302 redirect на ваш redirect_uri с параметрами code и state:

https://yourapp.example.com/callback?code=fw_oac_...&state=RANDOM_STATE

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

Используйте code из redirect для получения access_token и refresh_token.

Окно терминала
curl -X POST https://api.flowworker.ru/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code" \
-d "code=fw_oac_..." \
-d "redirect_uri=https://yourapp.example.com/callback" \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET" \
-d "code_verifier=$CODE_VERIFIER"

Пример успешного ответа:

{
"access_token": "fw_oat_...",
"refresh_token": "fw_ort_...",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "tasks:read tasks:write"
}

Передавайте access_token в заголовке Authorization при каждом запросе к API. Срок жизни токена - 1 час.

Окно терминала
curl https://api.flowworker.ru/api/public/v1/tasks \
-H "Authorization: Bearer fw_oat_..."

Когда access_token истёк, используйте refresh_token для получения нового. FlowWorker применяет rotation: каждый успешный refresh выдаёт новый refresh_token, старый становится погашенным (redeemed).

Окно терминала
curl -X POST https://api.flowworker.ru/oauth/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=refresh_token" \
-d "refresh_token=fw_ort_..." \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET"

Для явного завершения сессии отзовите токен через endpoint revocation.

Окно терминала
curl -X POST https://api.flowworker.ru/oauth/revoke \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "token=fw_oat_..." \
-d "client_id=YOUR_CLIENT_ID" \
-d "client_secret=YOUR_CLIENT_SECRET"

Отзыв немедленно аннулирует access_token и все связанные refresh_tokens. Пользователь может управлять подключёнными приложениями самостоятельно через Profile → Приложения.