---
title: "Pierwsze kroki z REST API"
description: "Utwórz token dostępu, wybierz zakresy uprawnień i odczytuj kampanie, leady i listy z własnych systemów."
url: https://scratcher.io/pl/help/developers/rest-api
language: pl
---

1. [Centrum pomocy](https://scratcher.io/pl/help)
2. [API, webhooki i MCP](https://scratcher.io/pl/help/developers)
3. Pierwsze kroki z REST API

# Pierwsze kroki z REST API

Utwórz token dostępu, wybierz zakresy uprawnień i odczytuj kampanie, leady i listy z własnych systemów.

REST API Scratchera pozwala twoim własnym systemom odczytywać kampanie, leady i listy, dodawać i aktualizować leady oraz zarządzać produktami. Ten artykuł jest dla dewelopera, który przeprowadza konfigurację. API jest dostępne od planu Basic wzwyż.

## Utwórz token dostępu

1. Przejdź do **Ustawienia** > **API** (w sekcji **Deweloperzy**).
2. W sekcji **Osobiste tokeny dostępu** kliknij **Utwórz osobisty token dostępu**.
3. Nadaj mu **Nazwa**, np. „Hurtownia danych”, i wybierz potrzebne **Zakresy uprawnień**. Daj mu tylko taki dostęp, jakiego potrzebuje.
4. Kliknij **Zapisz** i skopiuj token w polu **Sekret**. Zobaczysz go tylko raz, więc przechowuj go bezpiecznie, np. w menedżerze haseł.

Token należy do twojego użytkownika i ma dostęp do każdego konta, którego jesteś członkiem. Aby odebrać dostęp, otwórz token i kliknij **Odwołaj**.

## Zakresy uprawnień

- `read:campaigns`: odczyt kampanii
- `read:lists`: odczyt list leadów
- `read:leads` i `write:leads`: odczyt, tworzenie, aktualizacja i usuwanie leadów
- `read:placements` i `write:placements`: odczyt i zarządzanie miejscami wyświetlania
- `read:products` i `write:products`: odczyt i zarządzanie produktami

## Wyślij żądanie

Bazowy URL to `https://platform.scratcher.io/api/v1/`. Wyślij token w nagłówku `Authorization`:

```text
curl https://platform.scratcher.io/api/v1/accounts \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Accept: application/json"
```

## Najważniejsze endpointy

- `GET /me`: użytkownik, do którego należy token
- `GET /accounts`: konta, do których masz dostęp
- `GET /accounts/{account}/campaigns` i `/campaigns/{campaign}`: twoje kampanie
- `GET /accounts/{account}/campaigns/{campaign}/leads`: leady kampanii wraz z nagrodami, kodami i udzielonymi zgodami
- `GET /accounts/{account}/lists` i `/lists/{list}/leads`: listy leadów i ich leady, a także `POST`, `PUT` i `DELETE` do zarządzania leadami
- `/accounts/{account}/products`: produkty
- `/accounts/{account}/placements`: miejsca wyświetlania

Wyniki są stronicowane za pomocą `?page=`. Limit wynosi 60 żądań na minutę na użytkownika.

Pełna dokumentacja z przykładami i kolekcją Postman znajduje się w [dokumentacji API](https://platform.scratcher.io/docs/index.html). Prowadzi do niej także przycisk **Dokumentacja API** na platformie.

## Aplikacje OAuth

Jeśli tworzysz aplikację, z którą łączą się inni użytkownicy Scratchera, zarejestruj ją w **Moje aplikacje** > **Utwórz aplikację**, podając **Nazwa aplikacji** i **URI przekierowania**. Otrzymasz **Client ID** i **Client Secret**. Sekret jest wyświetlany tylko raz. Aplikacje zatwierdzone przez użytkowników są wymienione w sekcji **Autoryzowane aplikacje**, gdzie można odwołać ich dostęp.

API, webhooki i MCP

- [Pierwsze kroki z REST API](https://scratcher.io/pl/help/developers/rest-api)
- [Wysyłaj dane do swoich systemów za pomocą webhooków](https://scratcher.io/pl/help/developers/webhooks)
- [Scratcher MCP dla twoich własnych narzędzi AI](https://scratcher.io/pl/help/developers/mcp)

## Powiązane artykuły

- [Wysyłaj dane do swoich systemów za pomocą webhooków](https://scratcher.io/pl/help/developers/webhooks): Otrzymuj żądanie na własny URL, gdy ktoś się zapisze lub wygra – z podpisanym payloadem i logiem każdego dostarczenia.
- [Scratcher MCP dla twoich własnych narzędzi AI](https://scratcher.io/pl/help/developers/mcp): Wkrótce połączysz Claude, ChatGPT i inne narzędzia AI ze Scratcherem przez MCP. Oto, co wiemy do tej pory.
- [Połącz ponad 8000 aplikacji przez Zapier](https://scratcher.io/pl/help/integrations/zapier): Wysyłaj nowe zapisy ze Scratchera do Arkuszy Google, Slacka, swojego CRM lub tysięcy innych aplikacji przez Zapier.

## Nadal potrzebujesz pomocy?

Prawdziwi ludzie chętnie ci pomogą. Jeśli już korzystasz ze Scratchera, najszybciej skontaktujesz się z nami przez czat na platformie.

- **[Czat z nami](https://platform.scratcher.io/login)**

    Zaloguj się i kliknij przycisk czatu w prawym dolnym rogu. Rex odpowie od razu, a nasz zespół jest o jedno kliknięcie dalej.
- **[Umów spotkanie](https://scratcher.io/pl/book-a-meeting)**

    Bezpłatna 30-minutowa rozmowa wideo z naszym zespołem: prezentacja, pomysły na kampanie lub pomoc w konfiguracji.
- **[Napisz do nas](mailto:contact@scratcher.io)**

    Napisz na contact@scratcher.io, a odezwiemy się do ciebie.