Kimlik doğrulama
Her isteği organizasyonunuza ait bir Bearer token ile doğrulayın.
Kimlik yalnızca Authorization başlığıyla doğrulanır. Çerez kabul edilmez, token adres satırında (sorgu parametresi olarak) gönderilemez. Tüm uçlar aynı başlığı ister.
Authorization: Bearer pxn_live_…Bearer ve ardından token. Token olmayan ya da biçimi bozuk istekler 401 unauthorized alır.
Neden yalnızca başlık
Adresler sunucu loglarına ve Referer başlığına düşer; adreste taşınan bir token orada sızar. Çerez kabul edilmemesi de siteler arası istek sahteciliği (CSRF) yüzeyini tamamen ortadan kaldırır.
Temel adres
https://api.proxynet.io/api/v1İlk istek
curl -H "Authorization: Bearer pxn_live_…" \
https://api.proxynet.io/api/v1/meYanıt token'ın adını, yetkilerini ve bağlı olduğu organizasyonu içerir. Bir yetkisi olmayan uca yapılan istek 403 insufficient_scope döner; hangi yetkinin hangi uçları açtığıToken'lar ve yetkiler sayfasında.
Token'ı güvende tutun
- Token'ı ortam değişkeninde ya da gizli anahtar yöneticisinde tutun.
- Her entegrasyona ayrı token verin; bir token sızarsa yalnızca onu iptal edersiniz.
- Yalnızca gereken yetkileri seçin. İzleme sunucusunun
orders:writeyetkisine ihtiyacı yoktur. - Token oluşturma ve iptal etme olayları organizasyonun Aktivite sayfasına düşer.
Sık sorulanlar
Token'ı adres satırında gönderebilir miyim?
Hayır. ?token= gibi bir sorgu parametresi kabul edilmez; yalnızca Authorization başlığı okunur.
Tarayıcıdan çağırabilir miyim?
Hayır. API tarayıcıdan gelen çağrılara CORS izni vermez. Bu dokümantasyondaki Dene! paneli istekleri kendi proxy'miz üzerinden gönderir; kendi ön yüzünüzde isteği kendi sunucunuzdan yapın.
Bir token birden çok organizasyona erişebilir mi?
Hayır. Token oluşturulduğu organizasyona aittir. Başka bir organizasyonun hizmetleri için o organizasyonda ayrı bir token oluşturun.