Proxy API, Apideck Unify platformunun bir parçası olarak sunulan ve istemci ile hedef servisler arasında köprü görevi gören bir API'dir. Temel amacı, farklı alt servislere (örneğin CRM, muhasebe) yapılan istekleri tek bir uç nokta üzerinden yönlendirmektir. Bu sayede uygulamanızın birden fazla entegrasyonu yönetmesi kolaylaşır. API, isteklerin yönlendirileceği URL'yi ve yetkilendirme bilgilerini özel başlıklar (header) aracılığıyla alır. Özellikle çok sayıda harici hizmetle çalışan ve bu hizmetlerin API'lerini tek bir çatı altında toplamak isteyen geliştiriciler için tasarlanmıştır.
Hangi ihtiyaçlarda değerlendirilebilir?
- Çok sayıda harici API'yi tek bir uç noktadan yönetmek isteyen geliştiriciler
- Farklı müşterileri için farklı entegrasyonları yönetmesi gereken SaaS uygulamaları
- API entegrasyonlarını merkezi bir noktadan izlemek ve yönlendirmek isteyen ekipler
Yaygın kullanım alanları
Çoklu CRM Entegrasyonu
Uygulamanızın farklı müşterileri farklı CRM sistemleri kullanıyorsa, Proxy API ile her müşteriye özel yönlendirme yapabilirsiniz. Örneğin, bir müşteri Pipedrive kullanırken diğeri Salesforce kullanıyorsa, istekleri ilgili servise iletmek için x-apideck-service-id başlığını kullanabilirsiniz.
Merkezi Kimlik Doğrulama
Proxy API, Vault'ta saklanan erişim belirteçlerini kullanarak alt servislere yetkilendirme yapar. Bu sayede uygulamanızın her bir servis için ayrı kimlik doğrulama mantığı yazmasına gerek kalmaz; tüm istekler tek bir API anahtarı üzerinden yönetilir.
Esnek İstek Yönlendirme
Gelen isteğin yönlendirileceği URL'yi x-apideck-downstream-url başlığı ile dinamik olarak belirleyebilirsiniz. Ayrıca, x-apideck-downstream-method başlığı ile HTTP metodunu değiştirebilir veya x-apideck-downstream-authorization ile Vault yerine özel bir yetkilendirme başlığı gönderebilirsiniz.
İncelenmesi gereken noktalar
- API anahtarlarınızı gizli tutun; özellikle istemci tarafında paylaşmayın. Anahtarlarınız önemli yetkilere sahiptir ve ifşa edilmesi güvenlik riski oluşturur.
- x-apideck-consumer-id başlığı, her bir müşteri için benzersiz olmalıdır. Bu kimlik, Vault'ta saklanan entegrasyon bilgileriyle eşleştirilir.
- Birden fazla entegrasyon aktifse, hangi servise istek yapılacağını belirtmek için x-apideck-service-id başlığını kullanmanız gerekebilir. Aksi takdirde istekler varsayılan servise yönlendirilir.
WordPress.org
Kurulum ve geliştirme notları
Proxy API için resmi bir kurulum süreci sağlanmamıştır; API'yi kullanmak için Apideck platformuna kaydolmanız ve API anahtarı almanız gerekmektedir.
Proxy API'nin geliştirme süreci, isteklerin doğru başlıklarla yapılandırılmasını ve yönlendirme mantığının anlaşılmasını içerir. Resmi geliştirme dokümantasyonu sağlanmamıştır.
Hazır çözümün ötesinde
Özel geliştirme ne zaman değerlendirilebilir?
Proxy API, mevcut bir API entegrasyonu olarak kullanıma hazırdır. Ancak, projenizin ihtiyaçlarına göre özel bir yönlendirme katmanı veya veri dönüşümü gerekiyorsa, ZeplinGo olarak web yazılım projelerinizde bu API'yi nasıl entegre edeceğinizi birlikte planlayabiliriz. API'nin sunduğu esnek başlık yapısı, özel senaryolar için uyarlanabilir.
Ücretsiz ön çalışma isteyin →Değerlendirme soruları
Proxy API'yi kullanmak için hangi bilgilere ihtiyacım var?
Proxy API'yi kullanmak için Apideck platformuna kaydolup bir API anahtarı almanız gerekir. Ayrıca, isteklerinizde x-apideck-app-id ve x-apideck-consumer-id başlıklarını göndermeniz beklenir. Yönlendirme yapılacak URL ise x-apideck-downstream-url başlığı ile belirtilir.
Proxy API ile hangi servislere istek yapabilirim?
Proxy API, Apideck Unify platformunun desteklediği tüm servislere istek yapmanızı sağlar. Hangi servisin kullanılacağını x-apideck-service-id başlığı ile belirtebilirsiniz. Örneğin, 'pipedrive' gibi bir servis kimliği kullanabilirsiniz.
API anahtarımı nasıl güvende tutarım?
API anahtarlarınızı asla istemci tarafı kodlarda paylaşmayın. Anahtarlarınızı yalnızca sunucu tarafında saklayın ve yetkisiz erişime karşı koruyun. Apideck panelinizden anahtarlarınızı yönetebilir ve gerektiğinde yenileyebilirsiniz.
