Kimlik doğrulama
Özel uygulama, client_id ve client_secret ile client_credentials akışından erişim token'ı alır; ikas örneğinde süre 4 saattir. Token her istekte Authorization: Bearer başlığıyla gönderilir. App Store'daki admin uygulamaları OAuth2 Authorization Code ve refresh token kullanır. Ayrıntı: özel uygulama ve access token.
Adresler ve sürümler
| Adres | Ne için |
|---|---|
| https://api.myikas.com/api/v2/admin/graphql | Güncel GraphQL uç noktası; yeni entegrasyonlar için önerilir |
| https://api.myikas.com/api/v1/admin/graphql | Ekim 2025 öncesi entegrasyonlar ve yalnız v1'de kalan işlemler |
| https://api.myikas.com/api/admin/oauth/token | Token alma |
| https://api.myikas.com/api/v2/admin/upload/image | Görsel yükleme (v2); v1'de .../api/v1/admin/product/upload/image |
v1'deki tek save... işlemleri v2'de create... ve update... olarak ikiye ayrıldı. Ayrıntı: v1 ve v2.
İstek sınırları ve sayfalama
ikas genel olarak 10 saniyede en fazla 50 istek kabul eder; aşılınca 429 döner. Ayrıca hata oranı yüksek uygulamalar 30 dakikadan kalıcıya kadar uzanan sürelerle engellenir. Liste sorguları page ve limit ile sayfalanır: limit en az 1, en fazla 200, varsayılan 50. Tarih filtreleri milisaniye cinsinden Unix zamanı kullanır. Ayrıntı: istek sınırları ve sayfalama.
Hata yanıtları
| Durum | Anlamı |
|---|---|
| Token isteği 400 ya da 401 | client_id, client_secret ya da grant_type hatalı |
| GraphQL isteği 401 | Token süresi dolmuş ya da başlık eksik |
| 429 | 10 saniyelik istek sınırı aşıldı |
| Yanıtta errors dizisi | Sorgu, alan ya da yetki hatası; data boş ya da eksik olabilir |
| v2 toplu işlemde errors | Hatalı satırlar errorCode ve inputArrayIndex ile döner, diğerleri işlenir |
| Uzun süreli ret | Hata oranı nedeniyle uygulanan engelleme |
Tüm durumlar ve çözümleri hata yanıtları sayfasında.
ikas API işlemleri
Genel
Ürün ve katalog
Stok ve fiyat
Sipariş
Sık sorulanlar
ikas API REST mi, GraphQL mi?
ikas Admin API GraphQL'dir; tüm sorgu ve değişiklikler tek adrese POST edilir. Token alma ve görsel yükleme ise ayrı REST adresleridir.
ikas API için hangi bilgiler gerekir?
Yönetim panelinde oluşturduğunuz özel uygulamanın client_id ve client_secret değerleri. Saystok bağlantısında bunlara ek olarak mağaza adı ve isteğe bağlı Depo ID girilir.
ikas'ta stok neden varyant ve depo bazında?
ikas her varyantın stoğunu stok lokasyonuna göre ayrı tutar. Bu yüzden stok yazarken ürün, varyant ve stok lokasyonu kimliği birlikte gönderilir.
Saystok ikas'ta neleri yönetir?
Siparişleri 5 dakikada bir okur, stoğu varyant bazında seçilen depoya yazar, fiyatı günceller ve tek varyantlı yeni ürün açar. Müşteri soruları ve iade yönetimi ikas için yoktur; webhook da kullanılmaz.