---
title: v1 ve v2
description: Admin API sürümleri arasındaki farklar ve v2'ye geçiş.
---

ikas Admin API iki endpoint üzerinden sunulur. v2, Ekim 2025'te yayınlanan güncel sürümdür; v1 mevcut entegrasyonlar için çalışmaya devam eder.

| | v1 | v2 |
| --- | --- | --- |
| Endpoint | `https://api.myikas.com/api/v1/admin/graphql` | `https://api.myikas.com/api/v2/admin/graphql` |
| Yeni entegrasyonlar | Önerilmez | Önerilir |
| Kayıt oluşturma ve güncelleme | Tek `save...` mutation'ı | Ayrı `create...` ve `update...` mutation'ları |

## Referanstaki etiketler

- `v1 · v2`: İşlem iki endpoint'te de bulunur. Parametreler sürümler arasında farklıysa işlemin altında bir not gösterilir ve yalnızca bir sürümde olan alanlar ayrıca etiketlenir.
- `v2`: İşlem yalnızca v2 endpoint'inde bulunur.
- `v1`: İşlem yalnızca v1 endpoint'inde bulunur. v2'de bir karşılığı varsa işlemin altında bağlantısı verilir.

## save mutation'larından create / update'e geçiş

v1'deki `save...` mutation'ları, input'ta `id` gönderilip gönderilmemesine göre kayıt oluşturur ya da günceller. v2'de bu iki iş ayrı mutation'lara ayrılmıştır:

| v1 | v2 |
| --- | --- |
| `saveProduct` | [`createProduct`](https://builders.ikas.com/docs/admin-api/products#createProduct), [`updateProduct`](https://builders.ikas.com/docs/admin-api/products#updateProduct) |
| `saveCustomer` | [`createCustomer`](https://builders.ikas.com/docs/admin-api/customers#createCustomer), [`updateCustomer`](https://builders.ikas.com/docs/admin-api/customers#updateCustomer) |
| `saveCategory` | [`createCategory`](https://builders.ikas.com/docs/admin-api/categories#createCategory), [`updateCategory`](https://builders.ikas.com/docs/admin-api/categories#updateCategory) |
| `saveCampaign` | [`createCampaign`](https://builders.ikas.com/docs/admin-api/campaigns#createCampaign), [`updateCampaign`](https://builders.ikas.com/docs/admin-api/campaigns#updateCampaign) |
| `saveOrderTag` | [`createOrderTag`](https://builders.ikas.com/docs/admin-api/order-tags#createOrderTag), [`updateOrderTag`](https://builders.ikas.com/docs/admin-api/order-tags#updateOrderTag) |
| `saveVariantPrices` | [`updateVariantPrices`](https://builders.ikas.com/docs/admin-api/prices-and-stocks#updateVariantPrices) |
| `saveWebhook` | [`saveWebhooks`](https://builders.ikas.com/docs/admin-api/webhooks#saveWebhooks) |
| `campaignAddCoupons` | [`addCouponsToCampaign`](https://builders.ikas.com/docs/admin-api/coupons#addCouponsToCampaign) |
| `listMerchantSettings` | [`getMerchantSettings`](https://builders.ikas.com/docs/admin-api/merchant#getMerchantSettings) |

Diğer `save...` mutation'larının karşılıkları ilgili kaynak sayfasında, v1 işleminin altındaki notta yer alır.

<Callout type="warning" title="Yalnızca v1'de kalan işlemler">
Tedarikçi, ürün birimi, kademeli indirim, ürün sıralama ve mağaza politikası işlemleri şu an yalnızca v1 endpoint'inde bulunur. Bu işlemleri kullanan entegrasyonlar v1 endpoint'ini kullanmaya devam etmelidir.
</Callout>