ikas panelinizle tam entegrasyon kurarak iş akışınızı özelleştirmek ve dış sistemlerle haberleştirmek için Özel Uygulamalar oluşturabilirsiniz. Geliştirdiğiniz özel uygulamalar sayesinde, ürünlerden indirimlere, siparişlerden müşterilere kadar tüm mağaza verisine GraphQL API üzerinden tam erişim ve müdahale yetkisi kazanabilirsiniz.
Geliştirici Kaynakları: Tüm API fonksiyonları ve teknik detaylar için ikas'ın güncel ve kapsamlı API dökümantasyonuna https://ikas.dev adresinden ulaşabilirsiniz.
Özel uygulama oluşturmak için ilk olarak ikas panelinizde Uygulamalar > Uygulamalarım alanına gidin ve Özel Uygulamalara Git butonuna tıklayın.
Ardından özel uygulama oluşturmak için açılan ekrandan Özel Uygulama Ekle butonuna tıklayın.
Bu Sayfada
- Temel Bilgiler
- Uygulama Tipi
- İzinler
- Satış Kanalları
Temel Bilgiler
Bu alanda, uygulamanızın kimlik bilgilerini tanımlarsınız.
Uygulama Adı: Oluşturduğunuz uygulamanın amacını veya adını belirten bir isim girin (Ör:
my-ikas-app).E-Posta: Uygulamanızla ilgili bildirimlerin veya iletişimin yapılacağı bir e-posta adresi girin.
Uygulama Tipi
Uygulamanızın türünü buradan seçmelisiniz.
Standart Uygulama: GraphQL API aracılığıyla mağazanızla entegre olan standart ikas uygulamasıdır. (Genellikle dış entegrasyonlar için bu seçilir.)
Örnek Kullanım:
Farklı bir ERP/Muhasebe sisteminden toplu ürün yönetimi yapmak.
Tüm siparişleri harici bir kargo takip sistemine otomatik aktarmak.
MCP İstemcisi: Gelişmiş AI etkileşimleri ve otomasyonları için Model Context Protocol (MCP) istemcisidir.
Örnek Kullanım:
Bir yapay zeka (AI) sohbet robotunu bağlayarak (Örn: Cursor veya benzeri bir istemci) ürün açıklamalarını otomatik olarak optimize etmek.
İzinler
Bu alan, uygulamanızın hangi verilere erişebileceğini ve bu veriler üzerinde hangi işlemleri (okuma/düzenleme) yapabileceğini tanımladığınız en kritik bölümdür.
Buradaki tüm veri grupları için (Ürünler, Siparişler, Müşteriler, Kampanyalar, Envanter, Online Mağaza), uygulamanızın API (GraphQL) veya MCP aracılığıyla sadece Görüntüleme (Okuma) veya hem Görüntüleme hem de Düzenleme (Yazma) yetkisine sahip olup olmayacağını belirleyebilirsiniz.
Satış Kanalları
Özel uygulamanızın bir satış kanalı gibi davranmasını istiyorsanız bu seçeneği kullanabilirsiniz. Bu özellik, uygulamanızın Sipariş Oluşturma API'ını kullanarak harici kanallardan (Örn: bir pazar yeri, özel mobil uygulama) kolayca sipariş oluşturabilmesini sağlar.
Client ID ve Secret Bilgilerini Edinme
Gerekli tüm alanları doldurup izinleri belirledikten sonra uygulamayı kaydedin. Bu işlemin ardından, entegrasyonlarınızı yaparken kullanacağınız Client IDve Secret bilgileri otomatik olarak oluşturulacaktır. Bu bilgileri kullanarak ikas GraphQL API'ına güvenli bir şekilde bağlanabilir ve mağaza verilerinize erişim sağlayabilirsiniz.
