# siparis.app API

Siparişlerinizi, müşterilerinizi, ürünlerinizi ve stoğunuzu kendi yazılımınızdan okuyup yazmanızı sağlayan REST API. Kargo, iade ve fatura işlemleri de buradan yapılır; değişiklikler olay akışı ve webhook ile gelir. Kullanımı ücretsizdir.

## Tek bakışta

| Konu | Bilgi |
| --- | --- |
| Temel adres | Canlı: `https://api.siparis.app/v1` · Deneme: `https://api.sandbox.siparis.app/v1` (ayrı hesap ve `spk_test_` anahtarı; [Deneme ortamı](https://developer.siparis.app/deneme-ortami)) |
| Kimlik doğrulama | Her istekte `Authorization: Bearer <anahtar>` başlığı. Anahtarı işletme sahibi panelde [İşletme › Entegrasyonlar › Geliştirici](https://siparis.app/panel/developer) sayfasında oluşturur; anahtar yalnız sunucunuzda durur, tarayıcıya ve URL’ye yazılmaz. |
| İzinler | Anahtar yalnız seçilen kapsamları (izinleri) ve markaları görür; yazma izni okuma izni vermez. [Kapsamlar](https://developer.siparis.app/kapsamlar) |
| Biçim | JSON, UTF-8. Tutar ve miktar ondalık metindir (`"120.00"`), zaman RFC 3339 UTC’dir. Kimlikler önekli metindir (`ord_…`); [Kimlik önekleri](https://developer.siparis.app/sozluk) |
| Hız sınırı | Bağlantı başına 60 saniyede 600 puan; çoğu okuma 1–2 puandır. Aşımda `429` ve beklenecek saniyeyi veren `Retry-After` döner. Yeni satış (sipariş açma, başka kanaldaki satışı bildirme) bu bütçeye girmez. [Hız sınırı](https://developer.siparis.app/hiz-siniri) |
| Tekrar anahtarı | Her yazma isteğinde `Idempotency-Key` başlığı zorunludur (en çok 200 karakter, iş başına benzersiz). Ağ hatasında aynı anahtar ve aynı gövdeyle tekrar edin; iş iki kez yapılmaz, yanıta `Idempotent-Replayed: true` eklenir. |
| Sürüm | Adresteki `v1`. Yanıttaki `Siparis-Version` başlığı sürümü söyler; geriye uyumsuz değişiklik yeni sürümle gelir. [Değişiklik günlüğü](https://developer.siparis.app/degisiklikler) |
| Listeler | `{data, has_more, next_cursor}`; `limit` en çok 100. Sonraki sayfa için `next_cursor` değerini `cursor` olarak gönderin. [İmleçle listeleme](https://developer.siparis.app/listeleme) |
| Hatalar | `application/problem+json`; programınız `code` alanına göre karar verir. [Hata kodları](https://developer.siparis.app/hatalar) |
| Postman | [Postman koleksiyonunu indirin](https://developer.siparis.app/postman.json): bütün uçlar, `{{baseUrl}}` ve `{{apiKey}}` değişkenleriyle; anahtar içermez. |
| AI ile | [AI için belge dizini](https://developer.siparis.app/llms.txt), [OpenAPI](https://developer.siparis.app/openapi.json) ve [MCP bağlantısı](https://developer.siparis.app/mcp). |

## İlk istek

```bash
curl --fail-with-body --silent --show-error \
  "${SIPARIS_API_URL:-https://api.siparis.app/v1}/me" \
  -H "Authorization: Bearer $SIPARIS_API_KEY"
```

Yanıt anahtarın kapsamlarını, erişebildiği markaları ve bu ortamın adresini verir. Adım adım kurulum: [Başlarken](https://developer.siparis.app/baslarken).

## Kaynaklar

Menüdeki her grup bir kaynaktır; her ucun kendi sayfasında alanlar, örnek istek ve yanıt, o uca özgü hatalar bulunur. Hepsi bir arada: [Bütün uçlar](https://developer.siparis.app/uc-basvurusu).

- **Siparişler:** Sipariş açın, listeleyin, onaylayın, teslim edin, düzeltin ve iptal edin. [Sipariş oluştur](https://developer.siparis.app/uc/siparis-olustur), [Siparişleri listele](https://developer.siparis.app/uc/siparisleri-listele), [Siparişi getir](https://developer.siparis.app/uc/siparisi-getir)
- **Müşteriler:** Müşteri kartını bulun, ekleyin, güncelleyin, arşivleyin veya KVKK için anonimleştirin. [Müşteri oluştur](https://developer.siparis.app/uc/musteri-olustur), [Müşterileri listele](https://developer.siparis.app/uc/musterileri-listele), [Müşteriyi getir](https://developer.siparis.app/uc/musteriyi-getir)
- **Ürünler:** Ürün, seçenek, kategori, ürün markası ve markaya özel fiyat. [Ürün oluştur](https://developer.siparis.app/uc/urun-olustur), [Ürünleri listele](https://developer.siparis.app/uc/urunleri-listele), [Ürünü getir](https://developer.siparis.app/uc/urunu-getir)
- **Stok:** Depodaki miktarlar, stok girişi, sayım, fire, depolar arası taşıma ve stok geçmişi. [Stok miktarlarını listele](https://developer.siparis.app/uc/stok-miktarlarini-listele), [Stok girişi yap](https://developer.siparis.app/uc/stok-girisi-yap), [Stok sayımı yap](https://developer.siparis.app/uc/stok-sayimi-yap)
- **Kargo:** Kargo fiyatı sorun, BasitKargo gönderisi açın, etiket indirin ve iptal edin. [Kargo fiyatı sor](https://developer.siparis.app/uc/kargo-fiyati-sor), [Gönderi oluştur](https://developer.siparis.app/uc/gonderi-olustur), [Gönderiyi getir](https://developer.siparis.app/uc/gonderiyi-getir)
- **İade:** İade talebini karara bağlayın, ürünü geri alın ve parayı iade edin. [İadeyi önizle](https://developer.siparis.app/uc/iadeyi-onizle), [İade başlat](https://developer.siparis.app/uc/iade-baslat), [Para iadesini getir](https://developer.siparis.app/uc/para-iadesini-getir)
- **Fatura:** Fatura kesin, belgesini indirin ve iptal edin. [Faturayı önizle](https://developer.siparis.app/uc/faturayi-onizle), [Fatura kes](https://developer.siparis.app/uc/fatura-kes), [Faturayı getir](https://developer.siparis.app/uc/faturayi-getir)
- **Başka kanaldaki satış:** Ödemesi başka kanalda alınmış satışı stoğa ve sipariş listesine işleyin. [Başka kanaldaki satışı bildir](https://developer.siparis.app/uc/baska-kanaldaki-satisi-bildir)
- **Toplu işler:** Binlerce satırlık fiyat ve stok güncellemesini tek işte yapın. [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)
- **Kuponlar:** İndirim kuponlarını ekleyin, güncelleyin ve arşivleyin. [Kupon oluştur](https://developer.siparis.app/uc/kupon-olustur), [Kuponları listele](https://developer.siparis.app/uc/kuponlari-listele), [Kuponu getir](https://developer.siparis.app/uc/kuponu-getir)
- **Olaylar ve Webhook:** Değişiklikleri olay akışından okuyun ya da adresinize imzalı bildirim alın. [Olayları listele](https://developer.siparis.app/uc/olaylari-listele), [Olayı getir](https://developer.siparis.app/uc/olayi-getir), [Webhook adresi oluştur](https://developer.siparis.app/uc/webhook-adresi-olustur)
- **Dışa aktarma:** İlk eşitleme için tutarlı JSONL/CSV dosyası hazırlayın ve indirin. [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)
- **Uygulamalar (OAuth) ve MCP:** Başka satıcılar için uygulama yapmak (OAuth: /oauth/authorize, /oauth/token) ve AI asistanını /mcp adresine bağlamak. Uygulamalar ve MCP aynı REST uçlarını ve kapsamları kullanır. [Başka satıcılar için uygulama yapmak](https://developer.siparis.app/uygulama-yapmak), [Uygulama sözleşmesi ve KVKK taahhüdü](https://developer.siparis.app/uygulama-sozlesmesi), [AI asistanınızı bağlamak (MCP)](https://developer.siparis.app/mcp)
- **Hesap:** Bağlantıyı doğrulayın; işletmeyi ve markaları okuyun. [Bağlantıyı doğrula](https://developer.siparis.app/uc/baglantiyi-dogrula), [İşletmeyi getir](https://developer.siparis.app/uc/isletmeyi-getir), [Markaları listele](https://developer.siparis.app/uc/markalari-listele)

## Her yanıttaki başlıklar

Bu başlıklar bütün uçlarda aynıdır; uç sayfalarında yalnız o uca özgü başlıklar (ör. `ETag`, `Location`) yazılır.

| Başlık | Anlamı |
| --- | --- |
| `X-Request-ID` | Destek için istek takip kimliği. |
| `Siparis-Version` | Yanıtın API ana sürümü. |
| `RateLimit` | Kalan okuma puanı (r) ve kayan pencerenin uzunluğu, saniye (t). Kimliksiz sözleşme ucunda bulunmaz. |
| `RateLimit-Policy` | Bağlantı başına 60 saniyede 600 okuma puanı. Kimliksiz sözleşme ucunda bulunmaz. |
| `Retry-After` | Yeniden denemeden önce beklenecek saniye sayısı. |
| `Idempotent-Replayed` | Makbuz bulunduğunda true; işlem yeniden yürütülmez, kaynak güncel izinlerle okunur. |

Yapmak istediğiniz işi görev görev görmek için: [Neler yapabilirim](https://developer.siparis.app/neler-yapabilirim).