---
title: "Darba sākšana ar REST API"
description: "Izveidojiet personīgās piekļuves pilnvaru ar atbilstošām tiesībām vai reģistrējiet OAuth lietotni un nolasiet kampaņas, potenciālos klientus un sarakstus no savām sistēmām."
url: https://scratcher.io/lv/help/developers/rest-api
language: lv
---

1. [Palīdzības centrs](https://scratcher.io/lv/help)
2. [API, tīmekļa āķi un MCP](https://scratcher.io/lv/help/developers)
3. Darba sākšana ar REST API

# Darba sākšana ar REST API

Izveidojiet personīgās piekļuves pilnvaru ar atbilstošām tiesībām vai reģistrējiet OAuth lietotni un nolasiet kampaņas, potenciālos klientus un sarakstus no savām sistēmām.

Scratcher REST API ļauj jūsu sistēmām nolasīt jūsu kampaņas, potenciālos klientus un sarakstus, pievienot un atjaunināt potenciālos klientus, kā arī pārvaldīt produktus un izvietojumus. Šis raksts paredzēts izstrādātājam, kurš to iestata.

API ir pieejams plānos, kas ietver **Webhooks & API** (no Basic un augstāk). Citos plānos pogas pilnvaru un lietotņu izveidei ir bloķētas.

## Personīgās piekļuves pilnvaras izveide

Personīgās piekļuves pilnvara ir ātrākais veids, kā izsaukt API no saviem skriptiem un sistēmām.

1. Atveriet **Settings** > **API** (sadaļā **Developers**).
2. Sadaļā **Personal access tokens** noklikšķiniet uz **Create personal access token**. Dialoglodziņā redzams teksts „Generate a token to authenticate API requests.”
3. Piešķiriet tai **Name**, ko vēlāk atpazīsiet, piemēram, „Datu noliktava”.
4. Sadaļā **Scopes** izvēlieties, ko pilnvara drīkst darīt (skatiet tālāk). **Select all** atlasa visas tiesības. Piešķiriet pilnvarai tikai nepieciešamo piekļuvi.
5. Noklikšķiniet uz **Save**. Redzēsiet paziņojumu „Your access token has been created”.
6. Nokopējiet pilnvaru zem **Secret**. „Save the secret above, as this is the only time you will see it.” Glabājiet to drošā vietā, piemēram, paroļu pārvaldniekā.
7. Noklikšķiniet uz **Close**.

Pilnvara pieder jūsu lietotājam. Ar izvēlētajām tiesībām tā var piekļūt visiem Scratcher kontiem, kuros esat dalībnieks.

## Tiesības

- `read:campaigns` (**View campaigns**): kampaņu saraksta skatīšana un nolasīšana
- `read:lists` (**View lists**): potenciālo klientu sarakstu skatīšana un nolasīšana
- `read:leads` (**View leads**): potenciālo klientu nolasīšana
- `write:leads` (**Write leads**): potenciālo klientu izveide, atjaunināšana un dzēšana sarakstā
- `read:placements` (**View placements**): izvietojumu nolasīšana
- `write:placements` (**Write placements**): izvietojumu izveide, atjaunināšana un dzēšana
- `read:products` (**View products**): produktu nolasīšana
- `write:products` (**Write products**): produktu izveide, atjaunināšana un dzēšana

Lai nolasītu kampaņas potenciālos klientus, pilnvarai nepieciešamas gan `read:campaigns`, gan `read:leads` tiesības. Izvietojumu izveidei un mainīšanai jūsu plānā nepieciešama arī funkcija **Embed / URL**.

## Pilnvaras atsaukšana

Noklikšķiniet uz pilnvaras sarakstā, lai atvērtu **Show personal access token**. Tur redzams **Name** un **Scopes**. Noklikšķiniet uz **Revoke** un apstipriniet („Are you sure you want to delete this token? This cannot be undone!”). Viss, kas izmanto šo pilnvaru, nekavējoties pārstāj darboties.

## Pieprasījuma veikšana

Bāzes URL ir `https://platform.scratcher.io/api/v1/`. Nosūtiet pilnvaru galvenē `Authorization` un pieprasiet JSON:

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

## Galvenie galapunkti

- `GET /me`: lietotājs, kuram pieder pilnvara
- `GET /accounts`: konti, kuriem jums ir piekļuve. Citos izsaukumos izmantojiet konta id.
- `GET /accounts/{account}/campaigns` un `/campaigns/{campaign}`: jūsu kampaņas
- `GET /accounts/{account}/campaigns/{campaign}/leads`: kampaņas potenciālie klienti, sākot ar jaunākajiem, ar to laukiem, pieņemtajām piekrišanām un, uzvarētājiem, balvu un kodu
- `GET /accounts/{account}/lists` un `/lists/{list}`: jūsu potenciālo klientu saraksti
- `/accounts/{account}/lists/{list}/leads`: saraksta potenciālie klienti. `GET` nolasīšanai, `POST` izveidei, `PUT` atjaunināšanai un `DELETE` dzēšanai. Potenciālajam klientam ir `email`, `phone_number` un neobligāts `custom_token`.
- `/accounts/{account}/products`: produkti (`GET`, `POST`, `PUT`, `DELETE`)
- `/accounts/{account}/placements`: izvietojumi (`GET`, `POST`, `PUT`, `DELETE`)

Saraksti tiek dalīti lapās: pievienojiet `?page=2` un tā tālāk. Varat piekļūt tikai tiem kontiem, kuros esat dalībnieks; citu kontu id atgriež kļūdu.

## Ierobežojumi

Vienam lietotājam var veikt 60 pieprasījumus minūtē. Ja ierobežojums tiek pārsniegts, API atbild ar statusu 429; nedaudz uzgaidiet un mēģiniet vēlreiz.

## API dokumentācija

Pilna dokumentācija ar visiem laukiem, filtriem, piemēriem un Postman kolekciju pieejama [API dokumentācijā](https://platform.scratcher.io/docs/index.html). Uz to ved arī poga **API reference** lapas **Settings** > **API** augšdaļā.

## Lietotnes izveide ar OAuth

Ja veidojat lietotni, ko citi Scratcher lietotāji savieno ar saviem kontiem, personīgās pilnvaras vietā reģistrējiet OAuth lietotni.

1. Atveriet **Settings** > **API**. Sadaļā **My apps** noklikšķiniet uz **Create app** („Register an OAuth application for the API.”).
2. Aizpildiet **Application name** (lietotāji to redz, apstiprinot jūsu lietotni) un **Redirect URI** (kur lietotāji tiek novirzīti pēc apstiprināšanas).
3. Noklikšķiniet uz **Save**. Redzēsiet paziņojumu „Your app has been created!” ar **Client ID** un **Client secret**.
4. Nokopējiet klienta noslēpumu tagad: „Save the client secret above, as this is the only time you will see it.” Noklikšķiniet uz **Continue**.

Jūsu lietotne novirza lietotājus uz `https://platform.scratcher.io/oauth/authorize` ar jūsu klienta ID, novirzīšanas URI un nepieciešamajām tiesībām. Lietotājs piesakās Scratcher un redz **Authorization request**: „This application will be able to:”, kam seko tiesību saraksts. Lietotājs noklikšķina uz **Authorize** vai **Cancel**. Pēc tam jūsu lietotne apmaina kodu pret pilnvarām adresē `https://platform.scratcher.io/oauth/token`.

- OAuth piekļuves pilnvaras ir derīgas divus mēnešus. Atsvaidzināšanas pilnvaras ir derīgas trīs mēnešus; izmantojiet tās, lai iegūtu jaunu piekļuves pilnvaru.
- Lai mainītu nosaukumu vai novirzīšanas URI, noklikšķiniet uz lietotnes sadaļā **My apps**, veiciet izmaiņas un noklikšķiniet uz **Save** („Your settings have been saved”). „You cannot view your secret afterwards.”
- **Delete app** izdzēš lietotni, un visu lietotāju savienojumi ar to pārstāj darboties: „Are you sure you want to delete this app? This cannot be undone!”

## Jūsu apstiprinātās lietotnes

Sadaļā **Authorized apps** redzamas lietotnes, kurām esat piešķīris piekļuvi savam kontam, piemēram, Zapier, kopā ar to tiesībām. Noklikšķiniet uz **Revoke**, lai piekļuvi atsauktu.

## Kas var izmantot API?

Lapa **API** tiek rādīta lietotājiem ar lomu **Owner**, **Admin** vai **Manager**. Pilnvara nekad nevar darīt vairāk nekā lietotājs, kurš to izveidojis.

API, tīmekļa āķi un MCP

- [Darba sākšana ar REST API](https://scratcher.io/lv/help/developers/rest-api)
- [Sūtiet datus uz savām sistēmām ar tīmekļa āķiem (webhooks)](https://scratcher.io/lv/help/developers/webhooks)
- [Scratcher MCP jūsu AI rīkiem](https://scratcher.io/lv/help/developers/mcp)

Uzziniet vairāk

## Saistītie raksti

- [Sūtiet datus uz savām sistēmām ar tīmekļa āķiem (webhooks)](https://scratcher.io/lv/help/developers/webhooks): Saņemiet pieprasījumu uz savu URL, kad kāds reģistrējas, piedalās vai uzvar, ar parakstītu datu paketi, pamata autentifikāciju, pielāgotu datu paketi un katras piegādes žurnālu.
- [Scratcher MCP jūsu AI rīkiem](https://scratcher.io/lv/help/developers/mcp): Savienojiet Claude, ChatGPT un citus AI rīkus ar savu Scratcher kontu, izmantojot MCP. Uzziniet, kā to iestatīt un ko jūsu AI var paveikt.
- [Savienojiet vairāk nekā 8000 lietotņu ar Zapier](https://scratcher.io/lv/help/integrations/zapier): Ar Zapier palīdzību sūtiet jaunās reģistrācijas no Scratcher uz Google Sheets, Slack, savu CRM vai tūkstošiem citu lietotņu.

Vajadzīga palīdzība?

## Joprojām vajadzīga palīdzība?

Īsti cilvēki ir gatavi palīdzēt. Ja jau izmantojat Scratcher, ātrākais veids ir tērzēšana platformā.

- **[Tērzējiet ar mums](https://platform.scratcher.io/lv/login)**

    Piesakieties un noklikšķiniet uz tērzēšanas pogas apakšējā labajā stūrī. Rex atbild uzreiz, un mūsu komanda ir viena klikšķa attālumā.
- **[Rezervēt tikšanos](https://scratcher.io/lv/book-a-meeting)**

    Bezmaksas 30 minūšu videozvans ar mūsu komandu: platformas apskats, kampaņu idejas vai palīdzība ar iestatīšanu.
- **[Rakstiet mums](mailto:contact@scratcher.io)**

    Rakstiet uz contact@scratcher.io, un mēs jums atbildēsim.
