Bearer token или X-Profile-Token: как авторизоваться в SDK Relaya без путаницы

Какие схемы авторизации есть

В autogenerated-доках SDK Relaya фигурируют две схемы авторизации:

• BearerAuth с JWT-токеном в заголовке Authorization.
• ApiKeyAuth с заголовком X-Profile-Token.

Обе схемы уже отражены и в Node SDK, и в Python SDK, и в PHP SDK. То есть переключение между ними не требует ручной переписки клиента.

Когда брать Bearer

Bearer обычно удобнее для первого quickstart: вы задаёте токен пользователя или сервисного аккаунта и быстро проверяете базовый сценарий отправки.

• Подходит для ранних интеграций и большинства примеров из документации.
• Проще объясняется команде: один токен, один клиент, один быстрый запуск.
• Хороший старт, если вы ещё не строите изоляцию по профилям на уровне токенов.

Когда нужен X-Profile-Token

X-Profile-Token полезен, когда вызовы должны быть жёстко связаны с конкретным профилем. Это особенно логично в изолированных интеграциях, где разные профили живут как отдельные рабочие контуры.

• Обычно его берут там, где безопасность и разделение доступа важнее универсальности quickstart.
• Схема уже есть в SDK docs, поэтому менять язык или пакет ради неё не нужно.
• Если не уверены, начните с Bearer и переходите на profile token тогда, когда это диктует архитектура.

Примеры в SDK

Ниже три минимальных примера, как выглядит смена схемы авторизации без переписывания бизнес-логики.

// Node.js
import { IntegrationsApi, IntegrationsApiApiKeys } from "@relaya/sdk-node";
 
const api = new IntegrationsApi("https://api.relaya.ru/v1");
api.setApiKey(IntegrationsApiApiKeys.ApiKeyAuth, process.env.RELAYA_PROFILE_TOKEN || "");

# Python
import relaya_sdk
 
configuration = relaya_sdk.Configuration(
    host="https://api.relaya.ru/v1",
    api_key={"ApiKeyAuth": "YOUR_PROFILE_TOKEN"},
)

<?php
 
use Relaya\Sdk\Configuration;
 
$config = Configuration::getDefaultConfiguration()
    ->setApiKey('ApiKeyAuth', 'YOUR_PROFILE_TOKEN');

Если вам нужен следующий шаг после авторизации, переходите к quickstart по Node.js, Python или PHP.