Özel uygulama mı, admin uygulaması mı?
ikas iki tür uygulama tanımlar. Kendi mağazanıza bağlanan bir yazılım için özel uygulama yeterlidir. ikas App Store'da yayımlanıp birçok mağazaya kurulan uygulamalar ise admin uygulamasıdır (ikas: Yetkilendirme).
| Özellik | Özel uygulama | Admin uygulaması |
|---|---|---|
| Kim için | Tek mağaza, mağazaya özel entegrasyon | App Store'da yayımlanan, çok mağazalı uygulama |
| Token akışı | client_credentials | OAuth2 Authorization Code ve refresh token |
| İzinler nerede seçilir | Yönetim panelinde, uygulamayı oluştururken | OAuth yetkilendirme isteğinde |
| Nerede oluşturulur | Mağaza yönetim paneli | Partner hesabı ve ikas araçları |
Adım adım oluşturma
- Yönetim panelinde sol menüden Uygulamalar > Uygulamalarım sayfasına gidin.
- Özel uygulamalar bölümüne geçip yeni bir uygulama oluşturun.
- Uygulamanın ihtiyaç duyduğu izinleri (scope) işaretleyin.
- Kaydettiğinizde client_id ve client_secret görünür. ikas'a göre secret yalnız bir kez gösterilir; hemen güvenli bir yere kaydedin.
- Bu iki değerle access token alma adımına geçin.
Panel menü adları zamanla değişebilir. Güncel adımlar için ikas'ın özel uygulama hızlı başlangıç sayfasına bakın.
Stok entegrasyonu için hangi izinler?
| İş | v1 uç noktasında | v2 uç noktasında |
|---|---|---|
| Ürün ve varyant okuma | read_products | read_products |
| Ürün oluşturma ve düzenleme | write_products | write_products |
| Stok okuma | read_inventories | read_products |
| Stok yazma | write_inventories | write_inventories ya da write_products |
| Sipariş okuma | read_orders | read_orders |
Tablo ikas'ın yetkilendirme sayfasındaki scope açıklamalarından derlendi. Tüm liste scope izinleri sayfasında.
Güvenli saklama ve sık hatalar
ikas, client_secret, access token ve refresh token değerlerinin istemci tarafı koda, herkese açık depolara ya da paylaşılan Postman koleksiyonlarına eklenmemesini ister. Değerleri ortam değişkenlerinde tutun ve yalnız sunucu tarafında kullanın. Secret'ı paylaştığınız her yazılım, mağazanızda seçtiğiniz izinler ölçüsünde işlem yapabilir; yalnız güvendiğiniz entegrasyona verin.
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Token isteği reddediliyor | client_id ya da secret yanlış kopyalandı | Değerleri baştaki ve sondaki boşluklar olmadan yeniden girin |
| Secret artık görünmüyor | Tek seferlik gösterildi | Kayıtlı kopyayı kullanın; yoksa yeni bir özel uygulama oluşturun |
| İstek yetki hatası veriyor | Gereken izin seçilmedi | İzni panelde ekleyip yeni token alarak tekrar deneyin |
Sık sorulanlar
ikas client_id ve client_secret nereden alınır?
Yönetim panelinde Uygulamalar > Uygulamalarım bölümünden bir özel uygulama oluşturduğunuzda verilir. client_secret yalnız bir kez gösterilir.
ikas API için uygulama mağazasında yayın yapmam gerekir mi?
Hayır. Kendi mağazanıza bağlanacaksanız özel uygulama yeterlidir. App Store yayını, birçok mağazaya kurulan admin uygulamaları içindir.
ikas özel uygulama hangi akışla token alır?
client_credentials akışıyla. client_id ve client_secret token adresine gönderilir, dönen access token her istekte Bearer başlığıyla kullanılır.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı