---
title: "Začínáme s REST API"
description: "Vytvořte přístupový token, zvolte oprávnění a čtěte kampaně, leady a seznamy z vlastních systémů."
url: https://scratcher.io/cs/help/developers/rest-api
language: cs
---

1. [Centrum nápovědy](https://scratcher.io/cs/help)
2. [API, webhooky a MCP](https://scratcher.io/cs/help/developers)
3. Začínáme s REST API

# Začínáme s REST API

Vytvořte přístupový token, zvolte oprávnění a čtěte kampaně, leady a seznamy z vlastních systémů.

REST API Scratcheru umožňuje vašim vlastním systémům číst vaše kampaně, leady a seznamy, přidávat a aktualizovat leady a spravovat produkty. Tento článek je pro vývojáře, který API nastavuje. API je součástí tarifu Basic a vyšších.

## Vytvoření přístupového tokenu

1. Přejděte do **Nastavení** > **API** (pod **Vývojáři**).
2. V části **Osobní přístupové tokeny** klikněte na **Vytvořit osobní přístupový token**.
3. Zadejte **Název**, například „Datový sklad“, a zvolte **Oprávnění**, která token potřebuje. Dejte mu jen ten přístup, který opravdu potřebuje.
4. Klikněte na **Uložit** a zkopírujte token pod **Tajný klíč**. Uvidíte ho jen jednou, proto ho bezpečně uložte, například ve správci hesel.

Token patří vašemu uživateli a má přístup ke všem účtům, jejichž jste členem. Pokud chcete přístup odebrat, otevřete token a klikněte na **Odvolat**.

## Oprávnění (scopes)

- `read:campaigns`: čtení kampaní
- `read:lists`: čtení seznamů leadů
- `read:leads` a `write:leads`: čtení, vytváření, aktualizace a mazání leadů
- `read:placements` a `write:placements`: čtení a správa umístění
- `read:products` a `write:products`: čtení a správa produktů

## Odeslání požadavku

Základní URL je `https://platform.scratcher.io/api/v1/`. Token posílejte v hlavičce `Authorization`:

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

## Hlavní endpointy

- `GET /me`: uživatel, kterému token patří
- `GET /accounts`: účty, ke kterým máte přístup
- `GET /accounts/{account}/campaigns` a `/campaigns/{campaign}`: vaše kampaně
- `GET /accounts/{account}/campaigns/{campaign}/leads`: leady kampaně s výhrami, kódy a udělenými souhlasy
- `GET /accounts/{account}/lists` a `/lists/{list}/leads`: seznamy leadů a jejich leady, plus `POST`, `PUT` a `DELETE` pro správu leadů
- `/accounts/{account}/products`: produkty
- `/accounts/{account}/placements`: umístění

Výsledky jsou stránkované pomocí `?page=`. Limit je 60 požadavků za minutu na uživatele.

Kompletní referenci s příklady a kolekcí pro Postman najdete v [referenční dokumentaci API](https://platform.scratcher.io/docs/index.html). Odkazuje na ni i tlačítko **Reference API** v platformě.

## OAuth aplikace

Pokud vytváříte aplikaci, ke které se připojují další uživatelé Scratcheru, zaregistrujte ji v **Moje aplikace** > **Vytvořit aplikaci** s údaji **Název aplikace** a **URI pro přesměrování**. Dostanete **ID klienta** a **Tajný klíč klienta**. Tajný klíč se zobrazí jen jednou. Aplikace, které lidé schválili, jsou uvedené v **Autorizované aplikace**, kde je lze odvolat.

API, webhooky a MCP

- [Začínáme s REST API](https://scratcher.io/cs/help/developers/rest-api)
- [Posílání dat do vašich systémů pomocí webhooků](https://scratcher.io/cs/help/developers/webhooks)
- [Scratcher MCP pro vaše vlastní AI nástroje](https://scratcher.io/cs/help/developers/mcp)

## Související články

- [Posílání dat do vašich systémů pomocí webhooků](https://scratcher.io/cs/help/developers/webhooks): Dostávejte požadavek na vlastní URL, když se někdo zaregistruje nebo vyhraje, s podepsaným payloadem a záznamem každého doručení.
- [Scratcher MCP pro vaše vlastní AI nástroje](https://scratcher.io/cs/help/developers/mcp): Brzy budete moci připojit Claude, ChatGPT a další AI nástroje ke Scratcheru přes MCP. Tady je, co zatím víme.
- [Propojení s více než 8 000 aplikacemi přes Zapier](https://scratcher.io/cs/help/integrations/zapier): Posílejte nově registrované ze Scratcheru do Google Sheets, Slacku, svého CRM nebo tisíců dalších aplikací pomocí Zapieru.

## Pořád potřebujete pomoct?

Jsou tu pro vás skuteční lidé. Pokud už Scratcher používáte, nejrychlejší cestou je chat přímo v platformě.

- **[Napište nám do chatu](https://platform.scratcher.io/login)**

    Přihlaste se a klikněte na tlačítko chatu v pravém dolním rohu. Rex odpoví hned a náš tým je na jedno kliknutí.
- **[Domluvte si schůzku](https://scratcher.io/cs/book-a-meeting)**

    Bezplatný 30minutový videohovor s naším týmem: prohlídka platformy, nápady na kampaně nebo pomoc s nastavením.
- **[Napište nám e-mail](mailto:contact@scratcher.io)**

    Napište na contact@scratcher.io a ozveme se vám.