shop_id nerede kullanılır?
Etsy'de mağazaya bağlı kaynakların çoğu yolda shop_id ister. Kimlik yanlışsa istek başka bir mağazaya gider ya da 403 ve 404 alır.
| İşlem | Yol | shop_id gerekir mi? |
|---|---|---|
| Mağaza ilanları | /v3/application/shops/{shop_id}/listings | Evet |
| Taslak ilan açma | POST /v3/application/shops/{shop_id}/listings | Evet |
| Siparişler | /v3/application/shops/{shop_id}/receipts | Evet |
| Kargo profilleri | /v3/application/shops/{shop_id}/shipping-profiles | Evet |
| Envanter ve stok | /v3/application/listings/{listing_id}/inventory | Hayır, ilan kimliği yeter |
Yol 1: users/me ile tek istekte
Satıcı OAuth ile izin verdikten sonra GET /v3/application/users/me isteği atın. Etsy şemasına göre bu uç shops_r kapsamı ister ve yanıtta user_id ile shop_id alanlarını döndürür.
- x-api-key: KEYSTRING:SHARED_SECRET
- Authorization: Bearer KULLANICI_ID.TOKEN
Erişim token'ının başındaki sayı da Etsy belgesine göre izni veren kullanıcının kimliğidir. Bu sayı user_id'dir; shop_id ile karıştırmayın ve kimliği her zaman yanıttan okuyun.
Yol 2: kullanıcı kimliğinden mağazaya
Elinizde user_id varsa GET /v3/application/users/{user_id}/shops ucu kullanıcının mağazasını döndürür. Bu uç OAuth kapsamı istemez, x-api-key yeterlidir. Yanıtta shop_id, shop_name, url, currency_code ve is_vacation gibi alanlar bulunur.
currency_code alanı ayrıca önemlidir: Etsy'ye göre mağaza fiyatları varsayılan olarak bu para biriminde gösterilir. Fiyat hesaplayan bir entegrasyon bu değeri baştan okumalıdır.
Yol 3: mağaza adıyla arama
Mağaza adını biliyorsanız GET /v3/application/shops?shop_name=MAGAZA_ADI ile arama yapabilirsiniz. Bu uç da herkese açıktır. Sonuç bir liste döner; limit en az 1, en fazla 100'dür. Benzer adlı mağazalar gelebileceği için shop_name alanını tam olarak karşılaştırın.
Bulduğunuz kimliği GET /v3/application/shops/{shop_id} ile doğrulayın. Dönen shop_name ve url sizin mağazanızı göstermelidir.
Sık hatalar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| users/me 403 ya da 401 | Token'da shops_r yok ya da token geçersiz | Kapsamı ekleyip akışı yenileyin |
| Mağaza uçları 404 | shop_id yerine mağaza adı yazıldı | Sayısal kimliği kullanın |
| İlanlar boş geliyor | Başka bir hesabın token'ı | Token'ı veren hesabı ve mağazayı eşleştirin |
Kimliği bir kez bulduktan sonra mağaza kaydınızda saklayın. Her istekten önce users/me çağırmak gereksiz yere kota harcar. Etsy shop_id değerini mağazaya özgü benzersiz kimlik olarak tanımlar; farklı bir hesapla yeniden yetkilendirme yaptığınızda kimliği tekrar okuyun.
Sık sorulanlar
Etsy shop ID nerede yazar?
En güvenilir yol API'dir: OAuth token'ıyla GET /v3/application/users/me isteği yanıtta shop_id döndürür. Mağaza adını biliyorsanız herkese açık shops?shop_name= aramasıyla da bulabilirsiniz.
Mağaza adı ile shop_id aynı şey mi?
Hayır. Mağaza adı vitrinde görünen addır. shop_id sayısal bir kimliktir ve API yollarında bu kimlik kullanılır.
shop_id bulmak için OAuth gerekir mi?
users/me için gerekir. Kullanıcının mağazasını user_id ile getiren uç ve mağaza adıyla arama ucu ise yalnız x-api-key ile çalışır.
Kaynaklar
İlgili Etsy API konuları
Son güncelleme: 27.10.2026 · Etsy API rehberinin tamamı