API Anahtarı (API Key) Nedir?
API anahtarı (API key), bir yazılımın başka bir sistemin API’sine istek gönderirken kendini tanıttığı gizli kimlik bilgisidir; sağlayıcı isteği bu anahtarla hangi hesabın yaptığını doğrular.
Diğer Adları: API Key
API Anahtarı Nasıl Çalışır?
Sağlayıcı, satıcının ya da geliştiricinin hesabı için bir anahtar üretir. Entegrasyon yazılımı her istekte bu anahtarı, çoğu zaman bir gizli anahtarla birlikte gönderir; sağlayıcı anahtarı tanırsa isteği işler, tanımazsa yetkisiz yanıtı döner. Trendyol satıcı API’sinde örneğin doğrulama, satıcının API KEY ve API SECRET KEY değerleriyle temel kimlik doğrulama (Basic Authentication) yöntemiyle yapılır ve istek adresinde satıcı kimliği yer alır.
API Anahtarı ile OAuth Erişim Belirteci Farkı
API anahtarı çoğunlukla hesabın kendisine aittir, panelden elle oluşturulur ve yenilenene ya da iptal edilene kadar geçerli kalır. OAuth ile alınan erişim belirtecinde ise mağaza sahibi bir uygulamaya belirli kapsamlarda izin verir; belirteç yalnızca bu kapsamlardaki veriye erişir ve uygulama kaldırıldığında erişim sona erer. Üçüncü taraf bir uygulamanın mağazaya bağlanması için ana hesabın anahtarını paylaşmak yerine, altyapı izin veriyorsa OAuth tabanlı bağlantı tercih edilir.
API Anahtarı Güvenli Biçimde Nasıl Saklanır?
- Anahtar yalnızca sunucu tarafında, ortam değişkeni ya da gizli bilgi kasası gibi korumalı bir yerde tutulur; tarayıcıda çalışan koda, e-postaya ya da ekran görüntüsüne konmaz.
- Sağlayıcı izin veriyorsa ERP, kargo ve muhasebe gibi her entegrasyona ayrı anahtar ya da ayrı kullanıcı açılır; böylece biri iptal edildiğinde diğerleri çalışmaya devam eder.
- Bir ajans ya da yazılım firmasıyla çalışma bittiğinde ve anahtarın sızdığından şüphelenildiğinde anahtar hemen yenilenir.
Örnek: Bir mağaza, pazaryeri siparişlerini muhasebe programına aktarmak için entegratöre API anahtarını verir. Entegratörle çalışma sona erdiğinde anahtarı yenilemezse eski firma sipariş verisine erişebilmeye devam eder.
API Anahtarı (API Key) Hakkında Sık Sorulan Sorular
API anahtarı şifre yerine geçer mi?
Panele giriş şifresinin yerine geçmez, ama yazılımlar için en az onun kadar gizli tutulması gereken bir kimlik bilgisidir. Anahtarı ele geçiren kişi, anahtarın izin verdiği bütün API isteklerini hesap adına yapabilir.
API anahtarı test ve canlı ortamda aynı mı olur?
Çoğu sağlayıcıda test ve canlı ortam için ayrı anahtar ya da ayrı sunucu adresi bulunur. Trendyol’da istekler canlı ya da test sunucusuna gönderilebilir; hangi bilginin hangi ortamda geçerli olduğu sağlayıcının belgesinden kontrol edilir.