API anahtarları, erişim kapsamları ve test modu
Pro ve Team'de API anahtarlarını Dashboard > Alan adı ve API altında oluştur. Her anahtarın bir erişimi (Yalnızca okuma, Okuma ve yazma veya Tam erişim) ve bir modu vardır: canlı anahtarlar (pf_live_) gerçekten çalışır, test anahtarları (pf_test_) kimseye e-posta göndermez ve transferleri 24 saat sonra sona erer.
Pandafile API'si kendi uygulamalarının, betiklerinin ve sunucularının dosya göndermesini, yükleme toplamasını ve imza istemesini sağlar. Pro ve Team'e dahildir ve web sitesiyle aynı sınırlara uyar. Her şey bir API anahtarıyla başlar.
Anahtar oluştur
- Giriş yap ve Dashboard > Alan adı ve API'yi aç.
- API anahtarları altında anahtara bir ad ver, örneğin Web sitesi yüklemeleri.
- Anahtar modunu (Canlı veya Test) ve anahtar erişimini seç: Tam erişim, Okuma ve yazma ya da Yalnızca okuma.
- Anahtar oluştur'a bas ve anahtarı hemen kopyala. Güvenliğin için onu yalnızca bir kez gösteriyoruz.
- Her istekte Authorization: Bearer başlığında, ardından anahtarla birlikte gönder.
En fazla 10 etkin anahtarın olabilir. Canlı anahtarlar pf_live_, test anahtarları pf_test_ ile başlar. Geliştirici kılavuzu pandafile.co/developers adresinde, API referansı pandafile.co/developers/api adresindedir.
Erişim: bir anahtar neler yapabilir
- Yalnızca okuma: yalnızca GET istekleri. Anahtar bilgi alabilir ama hiçbir şeyi değiştiremez.
- Okuma ve yazma: Yalnızca okuma'daki her şey, ayrıca transferleri, dosya isteklerini, imza isteklerini ve webhook aboneliklerini oluşturma, değiştirme ve silme.
- Tam erişim: marka ve ekip davetleri gibi hesap ayarları dahil her şey.
Test modu
- pf_test_ anahtarıyla oluşturulan transferler test verisidir. Eklediğin alıcılar dahil hiç kimseye asla e-posta gönderilmez.
- Test transferleri oluşturulduktan 24 saat sonra her zaman sona erer ve uzatılamaz.
- Hiçbir sınıra, depolamaya veya kullanıma sayılmaz ve normal transfer listelerinde görünmezler.
- Bunlarla ilgili webhook olaylarında livemode değeri false olur ve asla Slack, Microsoft Teams veya Discord'a gitmez.
- Birkaç işlem yalnızca canlı anahtarla çalışır. Test anahtarıyla API bu durumda test_mode_unsupported hatasıyla yanıt verir.
Anahtarlarını güvende tut
- Anahtara sahip olan herkes hesabından dosya gönderebilir. Anahtarları sunucunda tut, asla bir web sitesinin veya uygulamanın herkese açık kodunda değil.
- Sızmış olabileceğini düşünüyorsan anahtarı Dashboard > Alan adı ve API'den iptal et. Onu kullanan uygulamalar hemen çalışmayı durdurur; onunla oluşturulan webhook abonelikleri de (örneğin Zapier veya Make tarafından) durur.
- Her anahtarın kendi istek sınırı vardır. Her yanıt RateLimit başlıklarında nerede olduğunu gösterir.
- Bir ekipte API anahtarları kişiseldir: her üye kendi anahtarlarını oluşturur.