İçeriğe geç
Rex, yapay zekâ asistanınız: angarya işler ondan, fikirler sizden 👉 Rex ile tanışı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:

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 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.

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

    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

    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

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