---
title: "REST API'yi kullanmaya başlayın"
description: "Doğru kapsamlarla kişisel erişim belirteci oluşturun veya bir OAuth uygulaması kaydedin; kampanyaları, lead'leri ve listeleri kendi sistemlerinizden okuyun."
url: https://scratcher.io/tr/help/developers/rest-api
language: tr
---

1. [Yardım merkezi](https://scratcher.io/tr/help)
2. [API, webhook'lar ve MCP](https://scratcher.io/tr/help/developers)
3. REST API'yi kullanmaya başlayın

# REST API'yi kullanmaya başlayın

Doğru kapsamlarla kişisel erişim belirteci oluşturun veya bir OAuth uygulaması kaydedin; kampanyaları, lead'leri ve listeleri kendi sistemlerinizden okuyun.

Scratcher REST API, kendi sistemlerinizin kampanyalarınızı, lead'lerinizi ve listelerinizi okumasını, lead eklemesini ve güncellemesini, ürünleri ve yerleşimleri yönetmesini sağlar. Bu makale, kurulumu yapan geliştirici için hazırlanmıştır.

API, **Webhooks & API** içeren planlara (Basic ve üzeri) dahildir. Diğer planlarda belirteç ve uygulama oluşturma düğmeleri kilitlidir.

## Kişisel erişim belirteci oluşturun

Kişisel erişim belirteci, API'yi kendi betiklerinizden ve sistemlerinizden çağırmanın en hızlı yoludur.

1. **Settings** > **API** bölümüne gidin (**Developers** altında).
2. **Personal access tokens** altında **Create personal access token** öğesine tıklayın. İletişim kutusunda "Generate a token to authenticate API requests." yazar.
3. Belirtece daha sonra tanıyacağınız bir **Name** verin; örneğin "Veri ambarı".
4. **Scopes** altında belirtecin neler yapabileceğini seçin (aşağıya bakın). **Select all** tüm kapsamları seçer. Belirtece yalnızca ihtiyaç duyduğu erişimi verin.
5. **Save** düğmesine tıklayın. "Your access token has been created" mesajını görürsünüz.
6. **Secret** altındaki belirteci kopyalayın. "Save the secret above, as this is the only time you will see it." Belirteci güvenli bir yerde, örneğin bir parola yöneticisinde saklayın.
7. **Close** düğmesine tıklayın.

Belirteç kullanıcınıza aittir. Seçtiğiniz kapsamlarla, üyesi olduğunuz tüm Scratcher hesaplarına erişebilir.

## Kapsamlar

- `read:campaigns` (**View campaigns**): kampanyaları listeleme ve okuma
- `read:lists` (**View lists**): lead listelerini listeleme ve okuma
- `read:leads` (**View leads**): lead'leri okuma
- `write:leads` (**Write leads**): bir listedeki lead'leri oluşturma, güncelleme ve silme
- `read:placements` (**View placements**): yerleşimleri okuma
- `write:placements` (**Write placements**): yerleşimleri oluşturma, güncelleme ve silme
- `read:products` (**View products**): ürünleri okuma
- `write:products` (**Write products**): ürünleri oluşturma, güncelleme ve silme

Bir kampanyanın lead'lerini okumak için belirtecin hem `read:campaigns` hem de `read:leads` kapsamına sahip olması gerekir. Yerleşim oluşturmak ve değiştirmek için ayrıca planınızda **Embed / URL** bulunmalıdır.

## Belirteci iptal edin

**Show personal access token** ekranını açmak için listedeki belirtece tıklayın. Burada **Name** ve **Scopes** görüntülenir. **Revoke** düğmesine tıklayıp onaylayın ("Are you sure you want to delete this token? This cannot be undone!"). Belirteci kullanan her şey anında çalışmayı durdurur.

## İstek gönderin

Temel URL `https://platform.scratcher.io/api/v1/` adresidir. Belirteci `Authorization` başlığında gönderin ve JSON isteyin:

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

## Temel uç noktalar

- `GET /me`: belirtecin ait olduğu kullanıcı
- `GET /accounts`: erişiminiz olan hesaplar. Diğer çağrılarda hesap kimliğini kullanın.
- `GET /accounts/{account}/campaigns` ve `/campaigns/{campaign}`: kampanyalarınız
- `GET /accounts/{account}/campaigns/{campaign}/leads`: bir kampanyanın lead'leri; en yeniden eskiye, alanları, kabul edilen onaylar ve kazananlar için ödül ile kodla birlikte
- `GET /accounts/{account}/lists` ve `/lists/{list}`: lead listeleriniz
- `/accounts/{account}/lists/{list}/leads`: bir listenin lead'leri. Okumak için `GET`, oluşturmak için `POST`, güncellemek için `PUT`, silmek için `DELETE`. Bir lead'in `email`, `phone_number` ve isteğe bağlı `custom_token` alanları vardır.
- `/accounts/{account}/products`: ürünler (`GET`, `POST`, `PUT`, `DELETE`)
- `/accounts/{account}/placements`: yerleşimler (`GET`, `POST`, `PUT`, `DELETE`)

Listeler sayfalara bölünmüştür: `?page=2` vb. ekleyin. Yalnızca üyesi olduğunuz hesaplara erişebilirsiniz; diğer hesap kimlikleri hata döndürür.

## Sınırlar

Kullanıcı başına dakikada 60 istek gönderebilirsiniz. Sınırı aşarsanız API 429 durum koduyla yanıt verir; kısa bir süre bekleyip tekrar deneyin.

## API başvurusu

Tüm alanları, filtreleri, örnekleri ve bir Postman koleksiyonunu içeren eksiksiz başvuru kaynağı [API başvuru belgelerinde](https://platform.scratcher.io/docs/index.html) yer alır. **Settings** > **API** sayfasının üst kısmındaki **API reference** düğmesi de bu belgelere bağlantı verir.

## OAuth ile uygulama geliştirin

Diğer Scratcher kullanıcılarının kendi hesaplarına bağladığı bir uygulama geliştiriyorsanız kişisel belirteç yerine bir OAuth uygulaması kaydedin.

1. **Settings** > **API** bölümüne gidin. **My apps** altında **Create app** öğesine tıklayın ("Register an OAuth application for the API.").
2. **Application name** (kullanıcılar uygulamanızı onaylarken bu adı görür) ve **Redirect URI** (kullanıcıların onaydan sonra geri yönlendirileceği adres) alanlarını doldurun.
3. **Save** düğmesine tıklayın. **Client ID** ve **Client secret** ile birlikte "Your app has been created!" mesajını görürsünüz.
4. İstemci gizli anahtarını hemen kopyalayın: "Save the client secret above, as this is the only time you will see it." **Continue** düğmesine tıklayın.

Uygulamanız kullanıcıları istemci kimliğiniz, yönlendirme URI'niz ve ihtiyaç duyduğu kapsamlarla `https://platform.scratcher.io/oauth/authorize` adresine yönlendirir. Kullanıcı Scratcher'a giriş yapar ve bir **Authorization request** görür: "This application will be able to:" ifadesinin ardından kapsamlar listelenir. Kullanıcı **Authorize** veya **Cancel** düğmesine tıklar. Ardından uygulamanız kodu `https://platform.scratcher.io/oauth/token` adresinde belirteçlerle değiştirir.

- OAuth erişim belirteçleri iki ay geçerlidir. Yenileme belirteçleri üç ay geçerlidir; yeni bir erişim belirteci almak için bunları kullanın.
- Adı veya yönlendirme URI'sini değiştirmek için **My apps** altındaki uygulamaya tıklayın, değişikliği yapın ve **Save** düğmesine tıklayın ("Your settings have been saved"). "You cannot view your secret afterwards."
- **Delete app** uygulamayı kaldırır ve tüm kullanıcıların uygulamayla bağlantısı çalışmayı durdurur: "Are you sure you want to delete this app? This cannot be undone!"

## Onayladığınız uygulamalar

**Authorized apps**, hesabınıza erişim verdiğiniz uygulamaları (örneğin Zapier) sahip oldukları kapsamlarla birlikte listeler. Erişimi geri almak için **Revoke** düğmesine tıklayın.

## API'yi kimler kullanabilir?

**API** sayfası **Owner**, **Admin** veya **Manager** rolüne sahip kullanıcılara gösterilir. Bir belirteç, onu oluşturan kullanıcının yapabileceğinden fazlasını asla yapamaz.

API, webhook'lar ve MCP

- [REST API'yi kullanmaya başlayın](https://scratcher.io/tr/help/developers/rest-api)
- [Webhook'larla verileri kendi sistemlerinize gönderin](https://scratcher.io/tr/help/developers/webhooks)
- [Kendi yapay zekâ araçlarınız için Scratcher MCP](https://scratcher.io/tr/help/developers/mcp)

Öğrenmeye devam edin

## İlgili makaleler

- [Webhook'larla verileri kendi sistemlerinize gönderin](https://scratcher.io/tr/help/developers/webhooks): Biri kaydolduğunda, katıldığında ya da kazandığında kendi URL'nize bir istek gelsin: imzalı payload, basic auth, özel payload ve her gönderimin kaydıyla.
- [Kendi yapay zekâ araçlarınız için Scratcher MCP](https://scratcher.io/tr/help/developers/mcp): Claude, ChatGPT ve diğer yapay zekâ araçlarını MCP ile Scratcher hesabınıza bağlayın. Kurulumu nasıl yapacağınızı ve yapay zekânızın neler yapabileceğini burada bulabilirsiniz.
- [Zapier ile 8.000'den fazla uygulamaya bağlanın](https://scratcher.io/tr/help/integrations/zapier): Zapier sayesinde Scratcher'daki yeni kayıtları Google Sheets'e, Slack'e, CRM'inize veya binlerce başka uygulamaya gönderin.

Yardıma mı ihtiyacınız var?

## Hâlâ yardıma mı ihtiyacınız var?

Size yardımcı olmak için gerçek insanlar burada. Scratcher'ı zaten kullanıyorsanız en hızlı yol platformun içindeki sohbettir.

- **[Bizimle sohbet edin](https://platform.scratcher.io/tr/login)**

    Giriş yapın ve sağ alt köşedeki sohbet düğmesine tıklayın. Rex hemen yanıt verir, ekibimiz de bir tık uzağınızda.
- **[Toplantı ayarlayın](https://scratcher.io/tr/book-a-meeting)**

    Ekibimizle ücretsiz 30 dakikalık görüntülü görüşme: bir tur, kampanya fikirleri veya kurulumunuz için destek.
- **[Bize e-posta gönderin](mailto:contact@scratcher.io)**

    contact@scratcher.io adresine yazın, size geri dönelim.
