---
title: "Първи стъпки с REST API"
description: "Създайте личен токен за достъп с правилните обхвати или регистрирайте OAuth приложение и четете кампании, лийдове и списъци от собствените си системи."
url: https://scratcher.io/bg/help/developers/rest-api
language: bg
---

1. [Помощен център](https://scratcher.io/bg/help)
2. [API, уебхукове и MCP](https://scratcher.io/bg/help/developers)
3. Първи стъпки с REST API

# Първи стъпки с REST API

Създайте личен токен за достъп с правилните обхвати или регистрирайте OAuth приложение и четете кампании, лийдове и списъци от собствените си системи.

REST API на Scratcher позволява на вашите собствени системи да четат кампаниите, лийдовете и списъците ви, да добавят и актуализират лийдове, както и да управляват продукти и позиции за вграждане. Тази статия е предназначена за разработчика, който го настройва.

API е включен в плановете с **Webhooks & API** (Basic и по-високи). При другите планове бутоните за създаване на токени и приложения са заключени.

## Създаване на личен токен за достъп

Личният токен за достъп е най-бързият начин да извиквате API от собствените си скриптове и системи.

1. Отидете в **Settings** > **API** (в раздел **Developers**).
2. В **Personal access tokens** щракнете върху **Create personal access token**. В прозореца пише „Generate a token to authenticate API requests.“
3. Дайте му **Name**, което ще разпознаете по-късно, например „Data warehouse“.
4. В **Scopes** изберете какво може да прави токенът (вижте по-долу). **Select all** избира всички обхвати. Давайте на токена само достъпа, от който наистина се нуждае.
5. Щракнете върху **Save**. Ще видите „Your access token has been created“.
6. Копирайте токена от **Secret**. „Save the secret above, as this is the only time you will see it.“ Съхранете го на сигурно място, например в мениджър на пароли.
7. Щракнете върху **Close**.

Токенът принадлежи на вашия потребител. С него имате достъп до всеки акаунт в Scratcher, в който членувате, в рамките на избраните обхвати.

## Обхвати

- `read:campaigns` (**View campaigns**): извеждане и четене на кампании
- `read:lists` (**View lists**): извеждане и четене на списъци с лийдове
- `read:leads` (**View leads**): четене на лийдове
- `write:leads` (**Write leads**): създаване, актуализиране и изтриване на лийдове в списък
- `read:placements` (**View placements**): четене на позиции за вграждане
- `write:placements` (**Write placements**): създаване, актуализиране и изтриване на позиции за вграждане
- `read:products` (**View products**): четене на продукти
- `write:products` (**Write products**): създаване, актуализиране и изтриване на продукти

За да чете лийдовете на дадена кампания, токенът се нуждае както от `read:campaigns`, така и от `read:leads`. Създаването и промяната на позиции за вграждане изисква и **Embed / URL** във вашия план.

## Отнемане на токен

Щракнете върху токена в списъка, за да отворите **Show personal access token**. Там се виждат **Name** и **Scopes**. Щракнете върху **Revoke** и потвърдете („Are you sure you want to delete this token? This cannot be undone!“). Всичко, което използва токена, спира да работи веднага.

## Изпращане на заявка

Базовият URL адрес е `https://platform.scratcher.io/api/v1/`. Изпратете токена в заглавката `Authorization` и поискайте JSON:

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

## Основни крайни точки

- `GET /me`: потребителят, на когото принадлежи токенът
- `GET /accounts`: акаунтите, до които имате достъп. Използвайте id на акаунта в останалите извиквания.
- `GET /accounts/{account}/campaigns` и `/campaigns/{campaign}`: вашите кампании
- `GET /accounts/{account}/campaigns/{campaign}/leads`: лийдовете на дадена кампания, като най-новите са първи, с техните полета, приетите съгласия, а за победителите – наградата и кода
- `GET /accounts/{account}/lists` и `/lists/{list}`: вашите списъци с лийдове
- `/accounts/{account}/lists/{list}/leads`: лийдовете в даден списък. `GET` за четене, `POST` за създаване, `PUT` за актуализиране и `DELETE` за изтриване. Лийдът има `email`, `phone_number` и незадължителен `custom_token`.
- `/accounts/{account}/products`: продукти (`GET`, `POST`, `PUT`, `DELETE`)
- `/accounts/{account}/placements`: позиции за вграждане (`GET`, `POST`, `PUT`, `DELETE`)

Списъците се връщат на страници: добавете `?page=2` и т.н. Имате достъп само до акаунти, в които членувате; другите id на акаунти връщат грешка.

## Ограничения

Можете да изпращате 60 заявки на минута на потребител. Ако надвишите лимита, API отговаря със статус 429; изчакайте малко и опитайте отново.

## Справочник за API

Пълният справочник с всички полета, филтри, примери и колекция за Postman е в [документацията на API](https://platform.scratcher.io/docs/index.html). Бутонът **API reference** в горната част на **Settings** > **API** също води към него.

## Създаване на приложение с OAuth

Ако създавате приложение, което други потребители на Scratcher свързват със собствения си акаунт, регистрирайте OAuth приложение вместо да използвате личен токен.

1. Отидете в **Settings** > **API**. В **My apps** щракнете върху **Create app** („Register an OAuth application for the API.“).
2. Попълнете **Application name** (потребителите го виждат, когато одобряват приложението ви) и **Redirect URI** (къде се връщат потребителите след одобрение).
3. Щракнете върху **Save**. Ще видите „Your app has been created!“ заедно с **Client ID** и **Client secret**.
4. Копирайте клиентската тайна веднага: „Save the client secret above, as this is the only time you will see it.“ Щракнете върху **Continue**.

Вашето приложение пренасочва потребителите към `https://platform.scratcher.io/oauth/authorize` с вашия client ID, redirect URI и нужните обхвати. Потребителят влиза в Scratcher и вижда **Authorization request**: „This application will be able to:“, последвано от обхватите. Той щраква върху **Authorize** или **Cancel**. След това приложението ви обменя кода за токени на `https://platform.scratcher.io/oauth/token`.

- Токените за достъп от OAuth са валидни два месеца. Токените за опресняване са валидни три месеца; използвайте ги, за да получите нов токен за достъп.
- За да промените името или redirect URI, щракнете върху приложението в **My apps**, направете промяната и щракнете върху **Save** („Your settings have been saved“). „You cannot view your secret afterwards.“
- **Delete app** премахва приложението и връзката на всеки потребител с него спира да работи: „Are you sure you want to delete this app? This cannot be undone!“

## Одобрени от вас приложения

**Authorized apps** показва приложенията, на които сте дали достъп до акаунта си, например Zapier, заедно с техните обхвати. Щракнете върху **Revoke**, за да отнемете достъпа.

## Кой може да използва API?

Страницата **API** се показва на потребители с роля **Owner**, **Admin** или **Manager**. Токенът никога не може да прави повече от потребителя, който го е създал.

API, уебхукове и MCP

- [Първи стъпки с REST API](https://scratcher.io/bg/help/developers/rest-api)
- [Изпращайте данни към своите системи чрез уебхукове](https://scratcher.io/bg/help/developers/webhooks)
- [Scratcher MCP за вашите собствени AI инструменти](https://scratcher.io/bg/help/developers/mcp)

Научете още

## Свързани статии

- [Изпращайте данни към своите системи чрез уебхукове](https://scratcher.io/bg/help/developers/webhooks): Получавайте заявка към свой собствен URL адрес, когато някой се регистрира, участва или спечели – с подписани данни, Basic Auth, персонализирано съдържание и дневник на всяка доставка.
- [Scratcher MCP за вашите собствени AI инструменти](https://scratcher.io/bg/help/developers/mcp): Свържете Claude, ChatGPT и други AI инструменти с акаунта си в Scratcher чрез MCP. Вижте как да го настроите и какво може да прави вашият AI.
- [Свържете над 8000 приложения чрез Zapier](https://scratcher.io/bg/help/integrations/zapier): Изпращайте новите регистрации от Scratcher към Google Sheets, Slack, вашата CRM система или хиляди други приложения чрез Zapier.

Нужна ви е помощ?

## Още имате нужда от помощ?

Истински хора са тук, за да помогнат. Ако вече използвате Scratcher, най-бързият начин е чатът в платформата.

- **[Пишете ни в чата](https://platform.scratcher.io/bg/login)**

    Влезте в профила си и натиснете бутона за чат в долния десен ъгъл. Rex отговаря веднага, а екипът ни е на едно кликване разстояние.
- **[Запазете среща](https://scratcher.io/bg/book-a-meeting)**

    Безплатен 30-минутен видеоразговор с екипа ни: обиколка, идеи за кампании или помощ с настройката.
- **[Пишете ни по имейл](mailto:contact@scratcher.io)**

    Пишете на contact@scratcher.io и ще ви отговорим.
