Uwierzytelnienie

Co musisz wiedzieć

tipply-sdk-ts nie implementuje logowania. SDK zakłada, że masz już aktywną sesję Tipply i potrafisz przekazać wartość auth_token.

W praktyce do klienta przekazujesz samą wartość tokena, nie cały nagłówek Cookie.

Zaloguj się do panelu użytkownika Tipply.
Otwórz DevTools skrótem F12.
Przejdź do zakładki Network.
Odśwież stronę.
Kliknij jedno z pierwszych żądań z pomarańczową ikoną, na przykład tips albo points.
Otwórz sekcję Response Headers.
Znajdź nagłówek Set-Cookie.
Skopiuj tylko fragment po auth_token= i przed pierwszym średnikiem.

Przykład:

Set-Cookie: auth_token=twoj-token-tutaj; Path=/; Secure; HttpOnly

Do SDK trafia wyłącznie:

twoj-token-tutaj

Najkrótsza i najczytelniejsza forma dla skryptów, CLI i testów live.

import { createTipplyClient } from "tipply-sdk-ts";

const client = createTipplyClient({
  authCookie: process.env.TIPPLY_AUTH_COOKIE!,
});

Równoważna forma, jeśli chcesz trzymać pełną konfigurację sesji w session.

const client = createTipplyClient({
  session: {
    authCookie: process.env.TIPPLY_AUTH_COOKIE!,
  },
});

Przydatne, gdy token pobierasz dynamicznie.

const client = createTipplyClient({
  getAuthCookie: async () => process.env.TIPPLY_AUTH_COOKIE,
});

Możesz też użyć wariantu z session:

const client = createTipplyClient({
  session: {
    getAuthCookie: async () => process.env.TIPPLY_AUTH_COOKIE,
  },
});

Do środowiska przeglądarkowego, kiedy sesja Tipply już istnieje po stronie przeglądarki.

const client = createTipplyClient({
  session: { browserSession: true },
  transport: { includeCredentials: true },
});

Dla endpointów auth SDK:

ustawia Referer na https://app.tipply.pl/
dla metod innych niż GET ustawia Origin na https://app.tipply.pl
wstrzykuje Cookie: auth_token=<wartosc> jeśli podasz token ręcznie
używa credentials: "include" przy requestach auth, jeśli includeCredentials jest włączone

Jeśli wywołasz endpoint auth bez:

i jednocześnie wyłączysz includeCredentials, SDK rzuci TipplyConfigurationError.