Ana içeriğe atla
API anahtarı, başka bir programın Perquery verilerinizi API üzerinden okumasını sağlar. Anahtarlar salt okunurdur ve organizasyonunuza aittir.

​
Başlamadan önce

  • Organizasyonunuzun API erişimi add-on’una sahip olması gerekir. Add-on’lar sayfasına bakın.
  • Rolünüzün API anahtarları izinlerine sahip olması gerekir. Roller ve izinler sayfasına bakın.
Sayfayı açmak için kullanıcı menüsünde API Anahtarları’na tıklayın.

​
Anahtar oluşturun

1

Formu açın

API Anahtarları sayfasında Anahtar oluştur’a tıklayın.
2

Anahtara ad verin

Ad alanını doldurun. Anahtarı nerede kullandığınızı gösteren bir ad seçin.
3

Son kullanma tarihi belirleyin (isteğe bağlı)

Son kullanma (isteğe bağlı) alanında bir tarih seçin. Tarih bugünden sonra olmalıdır. Tarih seçmezseniz anahtarın süresi dolmaz.
4

Oluşturun

Oluştur’a tıklayın.
5

Anahtarı kopyalayın

Kopyala’ya tıklayın. Anahtarı güvenli bir yerde, örneğin bir şifre yöneticisinde saklayın. Ardından Tamam’a tıklayın.
Perquery tam anahtarı yalnızca bir kez gösterir. Tamam’a tıkladıktan sonra anahtarı tekrar göremezsiniz. Anahtarı kaybederseniz onu iptal edin ve yenisini oluşturun.

​
Bir anahtarın okuyabildikleri

Her anahtar şu kapsamları alır. Kapsamlar sütunu bunları gösterir.
  • metrics:read: görünürlük, otorite, teknik analiz, içerik analizi, bot logları, fırsatlar, etki ve entegrasyonlar.
  • catalogue:read: siteler, promptlar, personalar ve rakipler.
  • runs:read: görünürlük, teknik analiz ve içerik analizi taramaları.
Bir anahtar, onu oluşturan üye olarak çalışır. O üyenin okuyabileceğinden fazlasını hiçbir zaman okuyamaz. Şu kurallar geçerlidir:
  • Üye bir izni kaybederse anahtar da o izni kaybeder.
  • Üye askıya alınırsa anahtar çalışmayı durdurur.
  • Kapsamların kapsadığı tüm izinlere sahip olmanız gerekir. Sahip değilseniz Perquery yeni anahtarı reddeder.

​
Anahtarı kullanın

Anahtarı her isteğin Authorization başlığında gönderin:
Bir anahtar yalnızca veri okuyabilir. Perquery veriyi değiştiren istekleri reddeder. Ayrıntılar için Kimlik doğrulama sayfasına bakın.

​
Anahtar listesi

API Anahtarları sayfası, iptal edilenler dahil organizasyonun tüm anahtarlarını listeler.

​
Anahtarı yeniden adlandırın

1

Yeniden adlandırmayı başlatın

Anahtarın satırında Yeniden adlandır’a (kalem simgesi) tıklayın.
2

Kaydedin

Yeni adı girin. Kaydet’e tıklayın.
Anahtarın değeri değişmez.

​
Anahtarı iptal edin

İptal edilen bir anahtar hemen çalışmayı durdurur. Onu tekrar çalışır hâle getiremezsiniz.
1

İptali başlatın

Anahtarın satırında İptal et’e (çöp kutusu simgesi) tıklayın.
2

Onaylayın

İptal edilsin mi?‘ye tıklayın.

​
İlgili sayfalar