Authorization Code + PKCE flow
Этот гайд проведёт вас через полный Authorization Code + PKCE flow: от генерации PKCE-пары до обновления и отзыва токенов.
Шаг 1: Генерация PKCE-пары
Заголовок раздела «Шаг 1: Генерация 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"async function generatePKCE() { // code_verifier: 32 случайных байта → base64url const array = new Uint8Array(32); crypto.getRandomValues(array); const codeVerifier = btoa(String.fromCharCode(...array)) .replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '');
// code_challenge: SHA-256 от verifier → base64url const encoder = new TextEncoder(); const data = encoder.encode(codeVerifier); const digest = await crypto.subtle.digest('SHA-256', data); const codeChallenge = btoa(String.fromCharCode(...new Uint8Array(digest))) .replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '');
return { codeVerifier, codeChallenge };}
const { codeVerifier, codeChallenge } = await generatePKCE();console.log('code_verifier:', codeVerifier);console.log('code_challenge:', codeChallenge);import hashlib, base64, os, re
# code_verifier: 32 случайных байта → base64urlcode_verifier = base64.urlsafe_b64encode(os.urandom(32)).rstrip(b'=').decode()
# code_challenge: SHA-256 → base64urldigest = hashlib.sha256(code_verifier.encode()).digest()code_challenge = base64.urlsafe_b64encode(digest).rstrip(b'=').decode()
print('code_verifier:', code_verifier)print('code_challenge:', code_challenge)<?php// code_verifier: 32 случайных байта → base64url$codeVerifier = rtrim(strtr(base64_encode(random_bytes(32)), '+/', '-_'), '=');
// code_challenge: SHA-256 → base64url$codeChallenge = rtrim(strtr(base64_encode(hash('sha256', $codeVerifier, true)), '+/', '-_'), '=');
echo "code_verifier: $codeVerifier\n";echo "code_challenge: $codeChallenge\n";Шаг 2: Запрос авторизации
Заголовок раздела «Шаг 2: Запрос авторизации»Перенаправьте пользователя на 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 - он должен совпадать со значением, которое вы отправили.
Шаг 3: Обмен кода на токены
Заголовок раздела «Шаг 3: Обмен кода на токены»Используйте 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"const response = await fetch('https://api.flowworker.ru/oauth/token', { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ grant_type: 'authorization_code', code: 'fw_oac_...', redirect_uri: 'https://yourapp.example.com/callback', client_id: 'YOUR_CLIENT_ID', client_secret: 'YOUR_CLIENT_SECRET', code_verifier: codeVerifier, }),});const tokens = await response.json();console.log(tokens);import requests
response = requests.post('https://api.flowworker.ru/oauth/token', data={ 'grant_type': 'authorization_code', 'code': 'fw_oac_...', 'redirect_uri': 'https://yourapp.example.com/callback', 'client_id': 'YOUR_CLIENT_ID', 'client_secret': 'YOUR_CLIENT_SECRET', 'code_verifier': code_verifier,})tokens = response.json()print(tokens)<?php$response = \Illuminate\Support\Facades\Http::asForm()->post( 'https://api.flowworker.ru/oauth/token', [ 'grant_type' => 'authorization_code', 'code' => 'fw_oac_...', 'redirect_uri' => 'https://yourapp.example.com/callback', 'client_id' => 'YOUR_CLIENT_ID', 'client_secret' => 'YOUR_CLIENT_SECRET', 'code_verifier' => $codeVerifier, ]);$tokens = $response->json();print_r($tokens);Пример успешного ответа:
{ "access_token": "fw_oat_...", "refresh_token": "fw_ort_...", "token_type": "Bearer", "expires_in": 3600, "scope": "tasks:read tasks:write"}Шаг 4: Использование access_token
Заголовок раздела «Шаг 4: Использование access_token»Передавайте access_token в заголовке Authorization при каждом запросе к API. Срок жизни токена - 1 час.
curl https://api.flowworker.ru/api/public/v1/tasks \ -H "Authorization: Bearer fw_oat_..."Шаг 5: Обновление токена (refresh)
Заголовок раздела «Шаг 5: Обновление токена (refresh)»Когда 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"Шаг 6: Отзыв токена
Заголовок раздела «Шаг 6: Отзыв токена»Для явного завершения сессии отзовите токен через 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 → Приложения.