Papo API anahtarlarını (https://papo.global/) oluşturmak için panele giriş yapın ve Ayarlar > Geliştiriciler (veya API) bölümüne gidin. Burada sabit genel anahtarınızı bulabilir ve yalnızca bir kez gösterilen, parola yöneticisi veya sunucudaki ortam değişkenleri gibi güvenli bir yerde saklanması gereken adlandırılmış gizli anahtarlar oluşturabilirsiniz.
Papo API'si, CRM'ler, ERP'ler, otomasyon platformları (n8n, Zapier) ve kendi sistemlerinizle entegrasyonlarda hesabınızı tanımlamak ve kimlik doğrulamak için bir anahtar çifti kullanır. Aralarındaki farkı anlamak ve bunları nasıl oluşturup koruyacağınızı bilmek, güvenilir otomasyonlar kurmanın ilk adımıdır.
| Anahtar Türü | Biçim | İşlev | Açığa Çıkma Düzeyi |
|---|---|---|---|
| Genel Anahtar | pk_live_... |
Papo hesabınızı benzersiz şekilde tanımlar. | Frontend'de veya herkese açık betiklerde açığa çıkarılabilir. |
| Gizli Anahtar | sk_live_... |
İsteklerin kimliğini doğrular ve hesabınızdaki eylemleri yetkilendirir. | Gizli – asla paylaşılmamalı veya kodda sürüm kontrolüne eklenmemelidir. |
API anahtarları nasıl oluşturulur
- Papo paneline giriş yapın ve Ayarlar bölümüne gidin.
- Yan menüde Geliştiriciler veya API bölümünü bulun.
- Sayfa, Genel Anahtarınızı (
pk_live_...) gösterir. Bu anahtar sabittir ve istediğiniz zaman kopyalanabilir. - Bir Gizli Anahtar almak için yeni anahtar oluşturma düğmesine tıklayın.
- Gelecekteki yönetimi kolaylaştırmak için açıklayıcı bir ad verin (örn. "CRM Entegrasyonu", "n8n Otomasyonu").
- Gizli anahtar (
sk_live_...) yalnızca bir kez gösterilir. Hemen kopyalayın ve güvenli bir yerde saklayın.
⚠️ Güvenlik nedeniyle Papo, gizli anahtarın yalnızca hash'ini saklar. Orijinal değeri kaybederseniz, bunu kurtarmak mümkün olmayacaktır. Bu durumda, tehlikeye giren anahtarı iptal edin ve yeni bir tane oluşturun.
Anahtarlar güvenli şekilde nasıl saklanır
- Gizli anahtarı asla doğrudan kaynak koduna, Git depolarına veya mesajlara koymayın.
- Sunucunuzda ortam değişkenlerini kullanın (örn.
PAPO_SECRET_KEY) ve kodda bunlara başvurun. - İleride başvurmak için anahtarı bir parola yöneticisinde (1Password, Bitwarden veya bulut sağlayıcınızın kasası gibi) saklayın.
- Anahtar sızarsa veya ele geçirildiğinden şüphelenirseniz, aynı geliştirici sayfasına gidin, listede anahtarı bulun ve derhal iptal edin. Ardından yeni bir tane oluşturun ve entegrasyonlarınızı güncelleyin.
Bu anahtarlar ne işe yarar?
Anahtarlar, kimlik doğrulama gerektiren tüm Papo API çağrılarında kullanılır. Gizli anahtar, Authorization başlığında Bearer token olarak gönderilir. Genel anahtar, ek doğrulama olarak X-Papo-Public-Key başlığında gönderilebilir, ancak asıl kimlik doğrulama her zaman gizli anahtara bağlıdır.
Anahtarlar elinizdeyken örneğin şunları yapabilirsiniz:
- API üzerinden WhatsApp mesajları gönderin.
- Extrator tarafından çıkarılan kişileri sorgulayın.
- Kendi sisteminizden Papo yapay zekasını tetikleyin.
- Verileri CRM veya ERP'nizle senkronize edin.
Sıkça Sorulan Sorular
Hesabımın genel anahtarını nerede bulurum?
Genel anahtar (pk_live_...), Ayarlar > Geliştiriciler (veya API) sayfasında görünür. Sabittir ve gerektiğinde her zaman kopyalanabilir.
Birden fazla gizli anahtarım olabilir mi?
Evet. Her biri farklı bir ada sahip birden fazla gizli anahtar oluşturabilirsiniz (örn. "Üretim", "Test", "n8n"). Bu, erişimleri yalıtmanıza ve diğerlerini etkilemeden belirli bir anahtarı iptal etmenize yardımcı olur.
Gizli anahtarımı kaybettim. Ne yapmalıyım?
Gizli anahtar kurtarılamaz. Geliştirici sayfasına gidin, kayıp anahtarı iptal edin ve yeni bir tane oluşturun. Entegrasyonlarınızı yeni değerle güncelleyin.
Kimlik doğrulama için genel anahtara ihtiyacım var mı?
Zorunlu değil. Kimlik doğrulama gizli anahtarla yapılır. Genel anahtar isteğe bağlıdır ve ek tanımlayıcı olarak hizmet eder, ancak gizli anahtarın yerini tutmaz.
Gizli anahtar nasıl iptal edilir?
Geliştirici sayfasındaki anahtar listesinde devre dışı bırakmak istediğiniz anahtarı bulun ve iptal etme seçeneğine tıklayın. Bu andan itibaren bu anahtarı kullanan tüm istekler reddedilir.
Anahtarları n8n veya Zapier gibi araçlarda kullanabilir miyim?
Evet. Papo API anahtarları, Bearer token ile kimlik doğrulamayı destekleyen her araçla uyumludur. Gizli anahtarı aracın yetkilendirme alanına girmeniz yeterlidir.
Ayrıca okuyun
Papo'da ücretsiz hesabınızı oluşturun ve sistemlerinizi entegre etmek için API anahtarlarına anında erişin.