---
title: Genel Bakış
description: ikas Admin API ile mağaza verilerine GraphQL üzerinden erişin.
---

ikas Admin API, yönetim panelinde yapılabilen işlemlerin büyük bölümünü GraphQL üzerinden sunar. Siparişleri listeleyebilir, ürün ve stok güncelleyebilir, müşteri ve kampanya yönetebilir, mağaza olaylarına webhook ile abone olabilirsiniz.

Bu referanstaki her sayfa bir kaynağı (sipariş, ürün, müşteri gibi) anlatır. Sol sütunda işlemin açıklaması, parametreleri ve dönen değeri; sağ sütunda GraphQL, cURL ve Node.js örnek isteği ile örnek yanıt yer alır.

## Endpoint'ler

| Sürüm | Endpoint | Durum |
| --- | --- | --- |
| v2 | `https://api.myikas.com/api/v2/admin/graphql` | Güncel sürüm. Yeni entegrasyonlar bu endpoint'i kullanmalıdır. |
| v1 | `https://api.myikas.com/api/v1/admin/graphql` | Ekim 2025 öncesi entegrasyonlar için. Yalnızca v1'de bulunan işlemler `v1` etiketiyle gösterilir. |

Tüm istekler `POST` yöntemiyle, `Content-Type: application/json` başlığı ve `Authorization: Bearer <access_token>` başlığıyla gönderilir. Token almak için [Yetkilendirme](https://builders.ikas.com/docs/admin-api/authorization) sayfasına bakın.

<Callout type="info" title="Sürüm etiketleri">
Her işlemin yanında hangi endpoint'te bulunduğunu gösteren bir etiket vardır: `v1 · v2` iki sürümde de, `v2` yalnızca yeni sürümde, `v1` yalnızca eski sürümde çalışır. Kenar çubuğundaki **Tümü · v2 · v1** seçiciyle yalnızca kullandığınız endpoint'te çalışan işlemleri listeleyebilirsiniz. Ayrıntılar için [v1 ve v2](https://builders.ikas.com/docs/admin-api/versions) sayfasını inceleyin.
</Callout>

## İlk istek

<Tabs items={['cURL', 'Node.js', 'Python', 'Go']} groupId="admin-api-rest-language" persist>
<Tab value="cURL">

```bash title="Terminal"
curl -X POST 'https://api.myikas.com/api/v2/admin/graphql' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $IKAS_ACCESS_TOKEN" \
  --data '{"query":"{ getMerchant { id storeName merchantName } }"}'
```

</Tab>
<Tab value="Node.js">

```js title="request.mjs"
const response = await fetch('https://api.myikas.com/api/v2/admin/graphql', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${process.env.IKAS_ACCESS_TOKEN}`,
  },
  body: JSON.stringify({ query: '{ getMerchant { id storeName merchantName } }' }),
});

const { data, errors } = await response.json();
```

</Tab>
<Tab value="Python">

```python title="request.py"
import os

import requests

response = requests.post(
    "https://api.myikas.com/api/v2/admin/graphql",
    json={"query": "{ getMerchant { id storeName merchantName } }"},
    headers={"Authorization": f"Bearer {os.environ['IKAS_ACCESS_TOKEN']}"},
)
response.raise_for_status()
result = response.json()
```

</Tab>
<Tab value="Go">

```go title="main.go"
package main

import (
	"bytes"
	"fmt"
	"io"
	"log"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{"query":"{ getMerchant { id storeName merchantName } }"}`)

	req, err := http.NewRequest(http.MethodPost, "https://api.myikas.com/api/v2/admin/graphql", bytes.NewReader(body))
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("Content-Type", "application/json")
	req.Header.Set("Authorization", "Bearer "+os.Getenv("IKAS_ACCESS_TOKEN"))

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer res.Body.Close()

	result, err := io.ReadAll(res.Body)
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(string(result))
}
```

</Tab>
</Tabs>

## Örnekler

Her işlemin yanında gerçek bir mağaza ya da uygulama senaryosuna dayanan bir istek örneği bulunur. İstek GraphQL, cURL, Node.js, Python ve Go olarak verilir; seçtiğiniz dil tüm sayfalarda açık kalır. Tüm örnekler güncel schema'ya göre doğrulanmıştır.

Kayıtlı bir yanıtı olmayan örneklerin yanıtı seçilen alanlardan üretilir ve "temsili örnek" olarak işaretlenir. Bu yanıtlardaki değerler yalnızca örnek amaçlıdır.

<Callout type="info" title="Schema'yı keşfedin">
Schema'yı canlı olarak keşfetmek ve istekleri denemek için [GraphQL Playground](https://builders.ikas.com/docs/admin-api/graphql-playground) sayfasını açın.
</Callout>

## Sınırlar

API isteklerine hız ve hata oranı limitleri uygulanır. Entegrasyonunuzu yayına almadan önce [Rate Limits ve Engelleme Kuralları](https://builders.ikas.com/docs/admin-api/rate-limits) sayfasını okuyun.

## Bu bölümdeki sayfalar


### Başlarken

- [Genel Bakış](https://builders.ikas.com/docs/admin-api.md): ikas Admin API ile mağaza verilerine GraphQL üzerinden erişin.
- [Yetkilendirme](https://builders.ikas.com/docs/admin-api/authorization.md): Admin API için access token alma ve isteklerde kullanma.
- [v1 ve v2](https://builders.ikas.com/docs/admin-api/versions.md): Admin API sürümleri arasındaki farklar ve v2'ye geçiş.
- [Sayfalama, Filtreleme ve Sıralama](https://builders.ikas.com/docs/admin-api/pagination-and-filtering.md): Liste sorgularında sayfalama, filtre operatörleri ve sıralama söz dizimi.
- [Rate Limits ve Engelleme Kuralları](https://builders.ikas.com/docs/admin-api/rate-limits.md): ikas Admin API için hız limitleri, hata oranı limitleri ve engelleme politikaları
- [GraphQL Playground](https://builders.ikas.com/docs/admin-api/graphql-playground.md): Admin GraphQL endpointini canlı olarak deneyin

### Siparişler

- [Siparişler](https://builders.ikas.com/docs/admin-api/orders.md): Siparişleri listeleyin, oluşturun, kargolayın, iptal ve iade edin.
- [Sipariş ödemeleri](https://builders.ikas.com/docs/admin-api/order-transactions.md): Siparişe ait ödeme işlemlerini ve ödeme yöntemlerini sorgulayın.
- [Faturalar](https://builders.ikas.com/docs/admin-api/order-invoices.md): Siparişlere fatura ekleyin, indirin ve kaldırın.
- [Sipariş etiketleri](https://builders.ikas.com/docs/admin-api/order-tags.md): Sipariş etiketlerini yönetin ve siparişlere etiket atayın.
- [Terk edilmiş sepetler](https://builders.ikas.com/docs/admin-api/abandoned-checkouts.md): Tamamlanmamış ödeme adımlarını sorgulayın.
- [Zaman çizelgesi](https://builders.ikas.com/docs/admin-api/timeline.md): Sipariş ve müşteri zaman çizelgesine kayıt ekleyin.

### Ürünler

- [Ürünler](https://builders.ikas.com/docs/admin-api/products.md): Ürünleri ve varyantlarını listeleyin, oluşturun, güncelleyin ve silin.
- [Fiyat ve stok](https://builders.ikas.com/docs/admin-api/prices-and-stocks.md): Varyant fiyatlarını ve stok miktarlarını güncelleyin.
- [Görsel yükleme](https://builders.ikas.com/docs/admin-api/product-media.md): Ürün, kategori ve marka görsellerini REST endpoint'i ile yükleyin.
- [Kategoriler](https://builders.ikas.com/docs/admin-api/categories.md): Ürün kategorilerini yönetin.
- [Markalar](https://builders.ikas.com/docs/admin-api/product-brands.md): Ürün markalarını yönetin.
- [Ürün etiketleri](https://builders.ikas.com/docs/admin-api/product-tags.md): Ürün etiketlerini yönetin.
- [Ürün özellikleri](https://builders.ikas.com/docs/admin-api/product-attributes.md): Ürün özelliklerini (attribute) yönetin.
- [Varyant tipleri](https://builders.ikas.com/docs/admin-api/variant-types.md): Beden, renk gibi varyant tiplerini ve değerlerini yönetin.
- [Ürün seçenek setleri](https://builders.ikas.com/docs/admin-api/product-option-sets.md): Ürünlere eklenen kişiselleştirme seçeneklerini yönetin.
- [Fiyat listeleri](https://builders.ikas.com/docs/admin-api/price-lists.md): Müşteri gruplarına veya satış kanallarına özel fiyat listelerini yönetin.
- [Diğer ürün kaynakları](https://builders.ikas.com/docs/admin-api/product-legacy.md): Yalnızca v1 endpoint'inde bulunan tedarikçi, birim, kademeli indirim ve ürün sıralama işlemleri.

### Müşteriler

- [Müşteriler](https://builders.ikas.com/docs/admin-api/customers.md): Müşterileri listeleyin, oluşturun, güncelleyin ve silin.
- [Müşteri grupları](https://builders.ikas.com/docs/admin-api/customer-groups.md): Müşteri gruplarını yönetin.
- [Müşteri etiketleri](https://builders.ikas.com/docs/admin-api/customer-tags.md): Müşteri etiketlerini yönetin.
- [Mağaza kredisi](https://builders.ikas.com/docs/admin-api/store-credits.md): Müşterilerin mağaza kredisi bakiyelerini sorgulayın ve güncelleyin.

### Kampanyalar

- [Kampanyalar](https://builders.ikas.com/docs/admin-api/campaigns.md): İndirim kampanyalarını ve kampanya tekliflerini yönetin.
- [Kuponlar](https://builders.ikas.com/docs/admin-api/coupons.md): Kampanyalara bağlı kupon kodlarını yönetin.

### Mağaza

- [Mağaza bilgileri](https://builders.ikas.com/docs/admin-api/merchant.md): Mağaza, lisans, ayar ve yetkili uygulama bilgilerini alın.
- [Satış kanalları](https://builders.ikas.com/docs/admin-api/sales-channels.md): Satış kanallarını sorgulayın ve güncelleyin.
- [Online mağazalar](https://builders.ikas.com/docs/admin-api/storefronts.md): Online mağazaları, JS script'lerini ve mağaza politikalarını yönetin.
- [Stok lokasyonları](https://builders.ikas.com/docs/admin-api/stock-locations.md): Depo ve mağaza stok lokasyonlarını sorgulayın.
- [Şubeler ve terminaller](https://builders.ikas.com/docs/admin-api/branches.md): Fiziksel mağaza şubelerini ve POS terminallerini sorgulayın.
- [Vergiler](https://builders.ikas.com/docs/admin-api/taxes.md): Ürün ve ülke bazlı vergi ayarlarını yönetin.
- [Kargo](https://builders.ikas.com/docs/admin-api/shipping.md): Kargo ayarlarını ve kargo firmalarını sorgulayın.
- [Konum ve para birimi verileri](https://builders.ikas.com/docs/admin-api/locations.md): Ülke, il, ilçe, mahalle ve para birimi listelerini alın.
- [İçe aktarma](https://builders.ikas.com/docs/admin-api/imports.md): Toplu içe aktarma işlerinin durumunu sorgulayın.

### Uygulama

- [Webhook'lar](https://builders.ikas.com/docs/admin-api/webhooks.md): Mağaza olaylarına webhook ile abone olun.
- [Uygulama ödemeleri](https://builders.ikas.com/docs/admin-api/app-payments.md): Uygulamanız için abonelik ödemesi alın.

- [Bölümün tamamı (llms-full.txt)](https://builders.ikas.com/docs/admin-api/llms-full.txt): Bu bölümdeki bütün sayfaların markdown içeriği tek dosyada.