Hepsiburada API kimlik bilgileri: hangi anahtar, nereden alınır?

Hepsiburada’da tek bir “API anahtarı” yok: entegratör servis anahtarı ile API istemci bilgileri farklı şeyler. Hangisinin size gerektiğini ve nereden alınacağını ayırıyoruz.

Hepsiburada entegrasyonuna başlayanların ilk takıldığı yer, aradıkları bilginin adının bile net olmaması. Bazı kaynaklar kullanıcı adı ve şifreden, bazıları servis anahtarından, Hepsiburada’nın kendi geliştirici portalı ise client_id ve client_secret‘ten söz ediyor.

Bunlar birbirinin eşanlamlısı değil. Hangisini kullanacağınız, entegrasyonu kimin yazdığına bağlı.

İki ayrı yol

Durum	İhtiyacınız olan
Hazır bir entegratör firmanın yazılımını kullanıyorsunuz	O entegratör için üretilmiş servis anahtarı
Entegrasyonu kendiniz yazıyorsunuz	Geliştirici portalından alınan API istemci bilgileri

Entegratör kullanıyorsanız: servis anahtarı

Satıcı panelinde izlenecek yol:

1. Bilgilerim altından Entegrasyon sayfasına gidin.
2. İkinci sekmede Entegratör Bilgileri yer alır.
3. Entegratörlerim listesinden ilgili entegratörü bulun.
4. Servis Anahtarı butonuna tıklayın ve kopyalayın.

Bu anahtar, entegratörün kendi ekranlarına girilir. Dikkat edilecek nokta şu: anahtar entegratör başına üretilir. Birden fazla entegratörle çalışıyorsanız her biri için ayrı anahtar vardır; birini diğerinin yerine kullanamazsınız.

Anahtarı yenilerseniz

Panelde “Yeni servis anahtarı oluşturmak istiyorum” seçeneği var. Yenilediğinizde eski anahtar geçersiz olur ve entegratör ekranlarındaki değeri de güncellemeniz gerekir. Hepsiburada bu konuda iki ayrı yerde uyarı veriyor; yine de en sık yaşanan kesinti sebeplerinden biri budur — anahtar yenilenir, entegratör tarafı güncellenmez, stok akışı sessizce durur.

Anahtarı yenilemeden önce entegratörünüze haber verin ve güncellemeyi aynı oturumda yapın.

Kendiniz yazıyorsanız: istemci bilgileri

Hepsiburada’nın geliştirici portalı, kimlik doğrulama için OAuth2 client credentials akışını gösteriyor:

curl --location 'https://api.hepsiburada.com/v3/auth' \
--header 'Content-Type: application/json' \
--data-raw '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "client_credentials"
}'

Bu akışta kimlik bilgilerini her isteğe değil, yalnızca bu uç noktaya gönderir; dönen jetonu sonraki çağrılarda kullanırsınız. Portal ayrıca sandbox bilgisi için bir geliştirici hesabı açmanızı ve anahtarları oradan üretmenizi öneriyor.

Trendyol’un her isteğe Basic auth başlığı koyan yaklaşımından farklı: burada jetonun ömrünü takip etmeniz ve süresi dolunca yenilemeniz gerekir. Jeton süresini kodunuza sabit yazmayın; yanıtta dönen değeri kullanın.

Neyi doğrulayamadık

Dürüst olalım: Hepsiburada’nın eski MPOP servisleri için anlatılan kullanıcı adı / şifre / merchantId üçlüsü hâlâ birçok üçüncü taraf kaynakta geçiyor. Bu bilgilerin güncel durumunu Hepsiburada’nın resmî dokümanından teyit edemedik.

Bu yüzden burada o yöntemin adımlarını vermiyoruz. Mevcut bir MPOP entegrasyonunuz varsa çalışmaya devam ediyor olabilir; yeni entegrasyon yazıyorsanız geliştirici portalındaki güncel akışı esas alın ve tereddüt hâlinde Hepsiburada entegrasyon desteğine sorun.

Anahtar güvenliği

• Servis anahtarını ve istemci bilgilerini koda gömmeyin; ortam değişkeni veya .env dosyası kullanın.
• .env dosyasını sürüm kontrolüne eklemeyin.
• Bu bilgiler asla tarayıcıya giden koda konmaz — yalnızca sunucu tarafında kalır.
• Destek talebi veya ekran görüntüsü paylaşırken değerleri maskeleyin.

Sırada ne var

Üç pazaryerinin kimlik doğrulama modellerini yan yana görmek için karşılaştırma yazısına bakabilirsiniz. Trendyol tarafıyla başlayacaksanız API anahtarı rehberi ve hata kodları yazısı işinizi görür.

Kaynak

Satıcı panelindeki servis anahtarı adımları Hepsiburada’nın geliştirici portalındaki “Entegratöre Servis Anahtarı Ekleme/Görüntüleme” dokümanından (30.04.2026 güncellemesi); OAuth2 istek örneği aynı portalın ana sayfasındaki başlangıç bölümünden alınmıştır.

Son kontrol: 6 Ekim 2026. Hepsiburada entegrasyon modellerini değiştirebilir; bir tutarsızlık fark ederseniz yorum bırakın, sayfayı güncelleyelim.