Anahtarın parçaları ne işe yarar?
Etsy belgesine göre keystring uygulamanızı tanıtır ve kalıcıdır; değiştirilemez. Shared secret ise isteğin size ait olduğunu kanıtlar ve gerektiğinde yenilenebilir (Etsy: Authentication). Aşağıdaki değerler sahtedir.
| Bilgi | Görevi | İstekte nerede durur | Örnek (sahte) |
|---|---|---|---|
| Keystring | Uygulamanın kimliği, değişmez | x-api-key başlığının ilk kısmı; OAuth isteklerinde client_id | KEYSTRING |
| Shared secret | İsteğin sizden geldiğini kanıtlar | x-api-key başlığının ikinci kısmı | SHARED_SECRET |
| Erişim token'ı | Mağaza sahibinin verdiği izin | Authorization: Bearer başlığı | KULLANICI_ID.TOKEN |
Doğru başlık şöyle görünür: x-api-key: KEYSTRING:SHARED_SECRET. Etsy bu başlığı uç noktadan bağımsız olarak her v3 isteğinde ister. Herkese açık uçlar yalnız bu başlıkla çalışır; mağaza siparişi, taslak ilan ya da stok gibi uçlar ek olarak OAuth token'ı gerektirir.
Hangi uygulama türünü seçmelisiniz?
Geliştirici portalında iki başlangıç yolu vardır. Kendi mağazanız için araç yazıyorsanız Seller App, başka satıcıların da kullanacağı bir araç yapıyorsanız Personal App seçilir. Personal App onaylandıktan sonra Commercial Access istenebilir.
| Tür | Kimin için | Onay | Mağaza erişimi |
|---|---|---|---|
| Seller App | Kendi mağazası için araç yapan satıcı | Uygun satıcıda otomatik, dakikalar içinde | Yalnız kayıtlı mağaza |
| Personal App | Sınırlı ölçekte başkalarına araç yapan geliştirici | Daha ayrıntılı inceleme | Onaylanan kullanım kadar |
| Commercial Access | Çok sayıda satıcıya hizmet veren uygulama | Elle inceleme | OAuth izni veren her satıcı |
Seller App ticari kullanıma açık değildir ve yalnız kendi mağazanızla yetkilendirilebilir. Etsy, Commercial Access başvurularında uygulamanın Etsy'den açıkça ayrıştığını belirten bir ibare taşımasını da şart koşar.
Kayıt ve ilk deneme
- Etsy hesabınızla geliştirici portalına girip uygun türde yeni bir uygulama oluşturun.
- "Your Apps" ya da "Manage your apps" sayfasında keystring ve shared secret değerlerini görün. Secret, göz simgesine basınca açılır.
- Etsy'nin hızlı başlangıç belgesine göre anahtar onaylanana kadar etkin değildir. Durumu aynı sayfadan izleyin.
- Anahtarı OAuth gerektirmeyen ping ucuyla deneyin: GET https://api.etsy.com/v3/application/openapi-ping. Başlıkta yalnız x-api-key bulunur.
Ping 200 dönerse yanıtta uygulama kimliğiniz görünür ve anahtar çalışıyor demektir. Etsy şemasına göre 401 eksik ya da geçersiz anahtar, 404 ise uygulamanın bu kaynağa yetkisi olmadığı anlamına gelir.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Ping 401 | Başlıkta yalnız keystring var ya da secret yanlış | Başlığı KEYSTRING:SHARED_SECRET biçiminde kurun |
| Ping 401, değerler doğru görünüyor | Kopyalarken boşluk girdi | Değerleri kırpıp yeniden yapıştırın |
| Ping çalışıyor, mağaza uçları 401 | Authorization başlığı eksik | OAuth akışını tamamlayıp Bearer token ekleyin |
| Anahtar hiçbir uçta çalışmıyor | Uygulama henüz onaylanmadı | Onay durumunu portalda kontrol edin |
Secret sızdıysa bekletmeyin; shared secret yenileme adımlarıyla yenisini üretin. OAuth tarafı yetkilendirme akışı sayfasında.
Sık sorulanlar
Etsy API key nereden alınır?
Etsy geliştirici portalında bir uygulama kaydedersiniz. Uygulamanın keystring ve shared secret değerleri "Your Apps" sayfasında görünür. Anahtar, uygulama onaylandıktan sonra çalışır.
Keystring ile Client ID aynı şey mi?
Evet. Etsy OAuth isteklerinde client_id olarak keystring kullanılır. Shared secret ise Client Secret karşılığıdır ve x-api-key başlığının ikinci kısmında gider.
Seller App ile başka bir mağazaya bağlanabilir miyim?
Hayır. Etsy'ye göre Seller App yalnız kayıtlı olduğu mağazayla yetkilendirilebilir. Başka satıcılara hizmet verecekseniz Personal App ve ardından Commercial Access gerekir.
Anahtarımın çalıştığını nasıl anlarım?
OAuth gerektirmeyen openapi-ping ucuna yalnız x-api-key başlığıyla istek atın. 200 yanıtı ve uygulama kimliği geliyorsa anahtar doğrudur.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı