İsteğin parçaları
| Parça | Değer |
|---|---|
| Yöntem | POST |
| Adres | https://api.myikas.com/api/v2/admin/graphql |
| Content-Type | application/json |
| Authorization | Bearer ACCESS_TOKEN |
| Gövde | query (zorunlu) ve variables (isteğe bağlı) alanlı JSON |
GraphQL'de hangi alanları istediğinizi siz seçersiniz. Yanıt yalnız sorguda yazdığınız alanları içerir; gereksiz alan istemek yanıtı büyütür.
İlk sorgu: mağaza bilgisi
ikas'ın genel bakış sayfasındaki ilk örnek, mağaza kimliğini ve adını döndüren getMerchant sorgusudur. Sorgu metni şudur: { getMerchant { id storeName merchantName } }.
- id: mağazanın kimliği.
- storeName: mağazanın adı.
- merchantName: mağaza personelinin adı.
Bu sorgu başarılı dönüyorsa token ve adres doğrudur. Yetki gerektiren asıl işlemlere geçmeden önce kimliği bu şekilde sınamak, hata ararken zaman kazandırır.
Değişken kullanımı
ikas örnekleri girdileri değişkenle gönderir: sorguda query ListProduct($pagination: PaginationInput) gibi bir tanım yapılır, değerler variables alanında yer alır; ör. pagination: { page: 1, limit: 50 }.
Değişken kullanmak, kullanıcıdan gelen metni sorgu metnine elle eklemekten daha güvenlidir. Değişkenler JSON olarak gittiği için ürün adındaki tırnak ya da ters bölü sorgu metnini bozmaz. Değişken tipinin adını (ör. PaginationInput) referanstaki işlem sayfasından ya da Playground'un şema gezgininden alın.
Yanıtı okuma
| Alan | Ne zaman gelir | Ne yapılmalı |
|---|---|---|
| data | İşlem çalıştığında | İstenen alanları buradan okuyun |
| errors | Sorgu, alan ya da yetki hatası olduğunda | Mesajı kaydedin; data eksik ya da boş olabilir |
| errors (v2 toplu işlem içinde) | Bazı satırlar reddedildiğinde | errorCode ve inputArrayIndex ile hatalı satırı bulun |
ikas'ın örnek kodu yanıttan data ve errors alanlarını birlikte okur. Bu yüzden yalnız HTTP durum koduna bakmak yetmez; errors alanı doluysa işlemi başarılı saymayın. Şemayı canlı keşfetmek ve istek denemek için ikas'ın GraphQL Playground sayfası kullanılır.
Sık hatalar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| 401 | Token eksik ya da süresi dolmuş | Yeni token alıp Bearer başlığıyla gönderin |
| errors: alan bulunamadı | Alan adı yanlış ya da o sürümde yok | Playground'da şemayı kontrol edin |
| errors: işlem bulunamadı | v1 işlemi v2 adresine gönderildi | İşlemin sürüm etiketine bakın |
| data boş liste | Filtre hiçbir kayıtla eşleşmedi | Filtreyi ve tarih biriminin milisaniye olduğunu kontrol edin |
Sık sorulanlar
ikas API'de GET isteği kullanılır mı?
Hayır. Admin API'de sorgular da değişiklikler de POST ile gönderilir. Ayrım, gövdedeki query metninin query ya da mutation ile başlamasıdır.
ikas mağaza adını API ile nasıl öğrenirim?
getMerchant sorgusunu storeName alanıyla çağırın. Aynı sorgu mağaza kimliğini de döndürür.
Hangi alanların var olduğunu nereden görürüm?
ikas'ın API referansında her işlemin parametre ve dönen değer tabloları vardır. GraphQL Playground'daki şema gezgini de tüm tipleri gösterir.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı