# Sık Sorulan Sorular

## Nesne, Operasyon ve Servis kavramları nedir?

- **Nesne:** E-ticaret sisteminde yer alan bir kavramın (ürün, sipariş, üye gibi) sahip olduğu tüm değerleri içinde barındıran özellikler bütünü.
- **Özellik:** Nesneye ait tekil bir değeri barındıran nitelik.
- **Operasyon:** Bir nesnenin kaydedilmesi, silinmesi, özelliklerinin değiştirilmesi veya görüntülenmesi gibi işlemleri gerçekleştiren tekil HTTP isteği. Bazı istisnai durumlarda nesne ilişkisi içermeyen işlemleri de sağlar (örn. önbellek temizleme).
- **Servis:** Nesneye yönelik benzer işlemlerin bir araya toplandığı operasyonlar grubu.

## Access Token nedir? Ne için kullanılır? Nasıl iletilir?

Access Token, Ideasoft online mağazasıyla API aracılığıyla güvenli iletişim sağlamak için kullanmanız gereken anahtardır. Ideasoft API, OAuth2 standartlarına uygun bir yetkilendirme mekanizmasına sahiptir. Bearer tipi token olduğu için `Authorization` başlığıyla iletilmesi gerekir:

```http
Authorization: Bearer <token>
```

Access Token alma ile ilgili tüm bilgiler için [Kimlik Doğrulama](/getting-started/authentication) dokümanına bakın.

## Yönlendirme adresi (Redirect URL) nedir? Ne için kullanılır?

Yönlendirme adresi, API uygulamanıza izin verildikten sonra access token alma sürecinin ilk aşaması olan `code` değerinin iletileceği ve aynı zamanda uygulamanıza izin veren kullanıcının da yönlendirileceği adrestir. Bu alana geçerli ve erişiminizin olduğu bir adres vermeniz önemlidir.

## Refresh Token nedir? Nasıl kullanılır?

Refresh Token, Access Token ile birlikte iletilen yenileme anahtarıdır. Bu anahtarla tek bir istekle yeni bir Access ve Refresh Token alabilirsiniz. Access Token 24 saat geçerlidir; süre dolduğunda yeniden yetkilendirme adımlarını tekrarlamamak için Refresh Token kullanılır. Refresh Token geçerliliği 2 aydır ancak kullanıldığı anda geçerliliğini yitirir ve yenisiyle değiştirilir.

## "Too many requests" hatası nedir?

`429` HTTP kodlu Too Many Requests hatası, arka arkaya çok sık istek ilettiğinizde alınır. İstek sıklığı limiti dinamik olarak değişen bir değerdir; kesin bir aralık verilemez. İsteklerinizin yarıda kesilmemesi için kodunuzu, bu hatayı alan isteği kısa süre bekletip tekrar gönderecek şekilde tasarlamanızı öneririz.

## C# örnek kodu verebilir misiniz?

Ideasoft API şu an için herhangi bir SDK'ya sahip değildir; ancak API referans sayfalarındaki örnekler birden fazla dilde görüntülenebilir. Postman gibi araçlarla oluşturduğunuz istekler için de otomatik örnek kod blokları üretebilirsiniz.

## Varyant nasıl eklenir?

Varyant ürünler, Ideasoft üzerinde ana ürüne bağlı birer üründür. Bir ürünü başka bir ürünün varyantı yapmak için öncelikle bir Varyant Grubu, bir Varyant ve varyant eklemek istediğiniz bir ana ürün oluşturmuş olmalısınız. Daha sonra bu değerleri Varyant Ürün Bağları servisi ile bağlamanız gerekir; bağı oluşturduğunuzda ana üründe varyant oluşur.

## Ürün resimleri nasıl eklenir? URL kullanabilir miyim?

Ürünlerinize resim eklemek için [Ürün Resim Oluşturma](/admin-api/productimage) servisini kullanmanız gerekir. Resimleri base64 formatına çevrilmiş biçimde iletmeniz gerekir; URL ile ekleme desteklenmez. İlgili servis içerisinde örnek istek bulunmaktadır.

## Ürün resimleri güncellenebiliyor mu?

Hayır. Ürün Resimleri servisinde güncelleme yoktur. Bir ürünün resmini değiştirmek istediğinizde o resmi silip yerine yeni bir resim oluşturmanız gerekir.

## Webhook isteği başarısız olursa tekrar gönderilir mi?

Yanıt koduna bağlıdır. Endpoint'iniz `5xx` dönerse istek yeniden denenir (varsayılan 3 deneme). `3xx`, `4xx` yanıtlarında veya zaman aşımında tekrar denenmez ve teslimat düşer. Bu durumda webhook aboneliğiniz silinmez; sonraki olaylar gönderilmeye devam eder. Ayrıntılar için [Teslimat ve Yeniden Deneme](/webhooks/delivery#yeniden-deneme-kuralı) sayfasına bakın.
