# API ile neler yapabilirim?

Gerçek veriye dokunmadan başlamak için [deneme ortamını](https://developer.siparis.app/deneme-ortami) kullanın.

API sipariş, müşteri, ürün, stok, kategori, ürün markası ve kupon bilgilerini okur ve yazar; kargo, iade ve fatura işlemlerini, başka kanaldaki kesinleşmiş satışı bildirmeyi ve toplu fiyat/stok güncellemeyi destekler. Değişiklikleri olay akışı ve webhook ile haber verir, toplu aktarım için dosya hazırlar. Aşağıdaki bütün görevler hazırdır. Her yazma isteği `Idempotency-Key` başlığı (tekrar anahtarı: aynı isteği güvenle yeniden göndermek için sizin ürettiğiniz benzersiz metin) ister.

“Gereken kapsam” sütunu, anahtarın o işi yapabilmesi için seçilmesi gereken izni gösterir; anahtar yalnız izin verilen markaların verisini görür. Uç adına tıklayınca alanları, örnek isteği ve yanıtı görürsünüz.

| Görev | Uç | Gereken kapsam | Rehber bağlantısı |
| --- | --- | --- | --- |
| AI asistanınızı bağlamak | `POST /mcp` | OAuth; araca göre aynı kaynak kapsamları | [AI asistanınızı bağlamak](https://developer.siparis.app/mcp) |
| Siparişleri listelemek (en yeni başta: `sort=-created_at`) | [Siparişleri listele](https://developer.siparis.app/uc/siparisleri-listele) | `orders:read` | [Siparişleri listelemek](https://developer.siparis.app/siparisleri-listelemek) |
| Tek siparişi ve satırlarını görmek | [Siparişi getir](https://developer.siparis.app/uc/siparisi-getir), [Sipariş satırlarını listele](https://developer.siparis.app/uc/siparis-satirlarini-listele) | `orders:read` | [Sipariş ayrıntısı](https://developer.siparis.app/siparisleri-listelemek) |
| Siparişi numarayla bulmak | [Siparişleri listele](https://developer.siparis.app/uc/siparisleri-listele) `?number=48273910` | `orders:read` | [Numarayla bulmak](https://developer.siparis.app/siparisleri-listelemek) |
| Yeni/değişen siparişleri almak | [Siparişleri listele](https://developer.siparis.app/uc/siparisleri-listele) `?updated_at_from=2026-10-16T09:00:00Z`, [Olayları listele](https://developer.siparis.app/uc/olaylari-listele) | `orders:read`; olaylar için ayrıca `events:read` | [Değişiklikleri almak](https://developer.siparis.app/siparisleri-listelemek) |
| Müşterileri listelemek | [Müşterileri listele](https://developer.siparis.app/uc/musterileri-listele) | `customers:read` | [Müşterileri bulmak](https://developer.siparis.app/musterileri-bulmak) |
| Müşteriyi e-posta/telefonla bulmak | [Müşterileri listele](https://developer.siparis.app/uc/musterileri-listele) `?email=Ornek@Example.com` veya `?phone=+90 500 000 00 00` | `customers:read`, `personal_data:read` | [E-posta ve telefonla aramak](https://developer.siparis.app/musterileri-bulmak) |
| Bir müşterinin siparişlerini görmek | [Siparişleri listele](https://developer.siparis.app/uc/siparisleri-listele) `?customer=cus_…&sort=-created_at` | `orders:read` | [Müşterileri bulmak](https://developer.siparis.app/musterileri-bulmak) |
| Ürünleri ve stoku okumak | [Ürünleri listele](https://developer.siparis.app/uc/urunleri-listele), [Stok miktarlarını listele](https://developer.siparis.app/uc/stok-miktarlarini-listele) | `products:read`, `inventory:read` | [Stoku eşitlemek](https://developer.siparis.app/stoku-esitlemek) |
| Değişikliklerde webhook almak | [Webhook adresi oluştur](https://developer.siparis.app/uc/webhook-adresi-olustur) | `webhooks:manage` ve seçilen kaynağın okuma kapsamı (ör. `orders:read`) | [Webhook](https://developer.siparis.app/webhook) |
| İlk toplu aktarımı yapmak (dışa aktarma) | [Dışa aktarma başlat](https://developer.siparis.app/uc/disa-aktarma-baslat), [Dışa aktarmanın durumunu getir](https://developer.siparis.app/uc/disa-aktarmanin-durumunu-getir), [Dışa aktarma dosyasını indir](https://developer.siparis.app/uc/disa-aktarma-dosyasini-indir) | `exports:write` ve kaynağın okuma kapsamı; devamındaki olaylar için `events:read` | [İlk eşitleme](https://developer.siparis.app/ilk-esitleme) |
| Sipariş eklemek | [Sipariş oluştur](https://developer.siparis.app/uc/siparis-olustur) | `orders:write`; müşteri ve adres için `personal_data:write` | [Sipariş eklemek](https://developer.siparis.app/siparis-eklemek) |
| Başka kanalda kesinleşmiş satışı bildirmek | [Başka kanaldaki satışı bildir](https://developer.siparis.app/uc/baska-kanaldaki-satisi-bildir) | `orders:write`; müşteri ve adres için `personal_data:write` | [Başka kanaldaki satışı bildirmek](https://developer.siparis.app/dis-satis-bildirmek) |
| Siparişi düzeltmek ve durumunu ilerletmek | [Siparişi düzelt](https://developer.siparis.app/uc/siparisi-duzelt), [Siparişi onayla](https://developer.siparis.app/uc/siparisi-onayla) vb. | `orders:write`; yerel para iadesi doğuyorsa `money_out:write` | [Sipariş eklemek ve ilerletmek](https://developer.siparis.app/siparis-eklemek) |
| Müşteri eklemek, güncellemek, arşivlemek | [Müşteri oluştur](https://developer.siparis.app/uc/musteri-olustur), [Müşteriyi güncelle](https://developer.siparis.app/uc/musteriyi-guncelle), [Müşteriyi arşivle](https://developer.siparis.app/uc/musteriyi-arsivle) | `customers:write`, `personal_data:write`; arşiv için `archive:write` | [Müşteri eklemek](https://developer.siparis.app/musteri-eklemek) |
| Müşteriyi KVKK kapsamında anonimleştirmek | [Müşteriyi anonimleştir (KVKK)](https://developer.siparis.app/uc/musteriyi-anonimlestir-kvkk) | `customers:write`, `customers:erase`, `personal_data:write` | [KVKK silme isteği](https://developer.siparis.app/musteri-eklemek) |
| Stok girmek, saymak, fire yazmak, depolar arası taşımak | [Stok girişi yap](https://developer.siparis.app/uc/stok-girisi-yap), [Stok sayımı yap](https://developer.siparis.app/uc/stok-sayimi-yap), [Fire ve kayıp yaz](https://developer.siparis.app/uc/fire-ve-kayip-yaz), [Depolar arası taşı](https://developer.siparis.app/uc/depolar-arasi-tasi) | `inventory:write`; alış fiyatı için `costs:write` | [Stok girmek, saymak ve taşımak](https://developer.siparis.app/stok-yazmak) |
| Ürün ve seçenek eklemek, güncellemek, arşivlemek; marka fiyatı yazmak | [Ürün oluştur](https://developer.siparis.app/uc/urun-olustur), [Ürünü güncelle](https://developer.siparis.app/uc/urunu-guncelle), [Ürüne seçenek ekle](https://developer.siparis.app/uc/urune-secenek-ekle), [Marka fiyatını yaz](https://developer.siparis.app/uc/marka-fiyatini-yaz) | `products:write`; maliyet için `costs:write`, arşiv için `archive:write` | [Ürün eklemek ve güncellemek](https://developer.siparis.app/urun-yazmak) |
| Kategori yazmak | [Kategori oluştur](https://developer.siparis.app/uc/kategori-olustur), [Kategoriyi güncelle](https://developer.siparis.app/uc/kategoriyi-guncelle), [Kategoriyi arşivle](https://developer.siparis.app/uc/kategoriyi-arsivle), [Kategoriyi geri getir](https://developer.siparis.app/uc/kategoriyi-geri-getir) | `products:write`; arşiv/geri getirme için `archive:write` | [Kategori, ürün markası ve kupon yazmak](https://developer.siparis.app/kupon-ve-kategori) |
| Ürün markası yazmak | [Ürün markası oluştur](https://developer.siparis.app/uc/urun-markasi-olustur), [Ürün markasını güncelle](https://developer.siparis.app/uc/urun-markasini-guncelle), [Ürün markasını arşivle](https://developer.siparis.app/uc/urun-markasini-arsivle), [Ürün markasını geri getir](https://developer.siparis.app/uc/urun-markasini-geri-getir) | `products:write`; arşiv/geri getirme için `archive:write` | [Kategori, ürün markası ve kupon yazmak](https://developer.siparis.app/kupon-ve-kategori) |
| Kupon yazmak | [Kupon oluştur](https://developer.siparis.app/uc/kupon-olustur), [Kuponu güncelle](https://developer.siparis.app/uc/kuponu-guncelle), [Kuponu arşivle](https://developer.siparis.app/uc/kuponu-arsivle), [Kuponu geri getir](https://developer.siparis.app/uc/kuponu-geri-getir) | `coupons:write`; arşiv/geri getirme için `archive:write` | [Kategori, ürün markası ve kupon yazmak](https://developer.siparis.app/kupon-ve-kategori) |
| Kargo oluşturmak/etiket almak | [Kargo fiyatı sor](https://developer.siparis.app/uc/kargo-fiyati-sor), [Gönderi oluştur](https://developer.siparis.app/uc/gonderi-olustur), [Kargo etiketini indir](https://developer.siparis.app/uc/kargo-etiketini-indir), [Gönderiyi iptal et](https://developer.siparis.app/uc/gonderiyi-iptal-et) | Açma/fiyat/iptal: `shipments:write`; okuma/etiket: `shipments:read`; etiket ayrıca `personal_data:read` | [Kargoya vermek](https://developer.siparis.app/kargo-gondermek) |
| İade yapmak | [İadeyi önizle](https://developer.siparis.app/uc/iadeyi-onizle), [İade başlat](https://developer.siparis.app/uc/iade-baslat), [İade talebini onayla](https://developer.siparis.app/uc/iade-talebini-onayla), [İade talebini reddet](https://developer.siparis.app/uc/iade-talebini-reddet) | `returns:write`; para iadesinde ayrıca `money_out:write`, geri gönderim kodunda `shipments:write` | [İade almak ve para iadesi](https://developer.siparis.app/iade-yapmak) |
| Başka satıcılar için uygulama yapmak — davetli | `GET /oauth/authorize`, `POST /oauth/token` | Satıcının onayladığı kapsamlar | [Uygulama yapmak](https://developer.siparis.app/uygulama-yapmak) |
| Toplu fiyat ve stok güncellemek | [Toplu fiyat güncelle](https://developer.siparis.app/uc/toplu-fiyat-guncelle), [Toplu stok say](https://developer.siparis.app/uc/toplu-stok-say), [Toplu işin durumunu getir](https://developer.siparis.app/uc/toplu-isin-durumunu-getir), [Toplu işin hatalarını listele](https://developer.siparis.app/uc/toplu-isin-hatalarini-listele) | `products:write` veya `inventory:write`; maliyet için `costs:write` | [Toplu güncelleme](https://developer.siparis.app/toplu-guncelleme) |
| Fatura oluşturmak | [Fatura kes](https://developer.siparis.app/uc/fatura-kes), [Faturayı iptal et](https://developer.siparis.app/uc/faturayi-iptal-et), [Fatura belgesini indir](https://developer.siparis.app/uc/fatura-belgesini-indir) | `invoices:write`; iptalde `money_out:write`; belgede `invoices:read personal_data:read` | [Fatura kesmek ve iptal etmek](https://developer.siparis.app/fatura-kesmek) |

Mevcut gönderi, iade ve fatura kayıtları sipariş altından da okunabilir. Webhook kurmak ve dışa aktarma başlatmak sipariş, müşteri, ürün veya stok verisini değiştirmez.

API temel adresi `https://api.siparis.app/v1`. İlk bağlantı için [Başlarken](https://developer.siparis.app/baslarken) sayfasını açın.

Sunucu uygulamanız için repodan kurulabilen [TypeScript ve Python SDK](https://developer.siparis.app/sdk) istemcilerini kullanabilirsiniz.