# Deneme ortamında denemek

> **Ne yaparsınız:** Gerçek sipariş, ödeme ve kargo oluşturmadan ayrı bir deneme hesabında bağlantınızı kurup denersiniz.
> **Hangi uçlar:** [Bağlantıyı doğrula](https://developer.siparis.app/uc/baglantiyi-dogrula); canlıdaki bütün uçlar deneme adresinde de aynıdır.
> **Gereken izin:** Canlıdakiyle aynı kapsamlar; `/me` için ek izin gerekmez.

İlk bağlantınızı gerçek sipariş ve ödeme oluşturmadan [deneme ortamında](https://sandbox.siparis.app) kurun.
Canlıdan ayrı hesap, veri tabanı ve API anahtarları kullanılır. Panel ve vitrindeki sarı şerit her sayfada
“Deneme ortamı — gerçek sipariş, ödeme ve kargo yok” yazar; kapatılamaz.

## Adresler ve hesap açma

| Ne | Adres |
| --- | --- |
| Hesap açma | [sandbox.siparis.app/register](https://sandbox.siparis.app/register) |
| Panel | [sandbox.siparis.app/panel](https://sandbox.siparis.app/panel) |
| Marka vitrini | `https://<marka>.sandbox.siparis.app` |
| API | `https://api.sandbox.siparis.app/v1` |
| Belgeler | [developer.siparis.app](https://developer.siparis.app) |

1. Deneme adresinde hesap açın. Canlı hesabınız burada geçmez. Gerçek müşteri veya kart bilgisi kullanmayın.
2. E-posta gönderilmez. Panelde “Doğrulama bağlantısı oluştur”a basın, ekrandaki “Deneme hesabımı doğrula” bağlantısını açın.
3. İşletmenizde birkaç sentetik ürün, renk seçenekleri, stok, 2 müşteri ve 2 sipariş hazırdır. Yeni işletme
   açınca da hazırlanır. Yeni marka açmak ürünleri veya siparişleri çoğaltmaz.
4. İşletme sahibi olarak **İşletme › Entegrasyonlar › Geliştirici** sayfasından anahtar oluşturun.
   Ekip üyelerinin anahtar yönetimi yetkisi yoktur; anahtarın erişeceği marka (tek marka veya bütün markalar) canlıdaki gibi seçilir.

## İlk istek

Anahtar `spk_test_` ile başlar ve yalnız bir kez gösterilir. Sunucunuzda `SIPARIS_API_KEY` değişkenine kaydedin.
Rehberlerdeki diğer örnekleri de aşağıdaki `SIPARIS_API_URL` ile çalıştırabilirsiniz.

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

Yanıtta `environment` değeri `test`, `api_url` değeri `https://api.sandbox.siparis.app/v1` olur.
Canlı adrese deneme anahtarı gönderirseniz `401 test_key_in_live`; deneme adresine canlı `spk_live_` anahtarı
gönderirseniz `401 live_key_in_sandbox` alırsınız. Kapsamlar (anahtarın erişim izinleri), marka sınırları,
`Idempotency-Key` (aynı isteği güvenle tekrarlamak için ürettiğiniz tekrar anahtarı), `If-Match` (kayıt siz
okuduktan sonra değiştiyse yazmayı durduran sürüm denetimi) ve hata yanıtları canlıyla aynıdır. Anahtarı tarayıcıya, URL’ye veya AI sohbetine yazmayın.

## Sahte servisler nasıl davranır?

Deneme ortamı sağlayıcıların test hesaplarına bile bağlanmaz. Gerçek para, gönderi, fatura, mesaj veya
pazaryeri kaydı oluşmaz. Bağlantı kurarken yalnız örnek kimlik bilgileri kullanın.

| Servis | Denemedeki davranış |
| --- | --- |
| PayTR | Sahte ödeme sayfasında onay veya ret seçilir. Örnek mağaza numarası `123456`, anahtarı `fakeKEY123456`, tuzu `fakeSALT123456`. Gerçek kart girilmez. |
| iyzico | Sahte ödeme formunda `5528790000000008` başarılı, `4111111111111129` yetersiz bakiye, `4129111111111111` reddedilen ödeme örneğidir. Gelecek bir son kullanma tarihi ve örnek güvenlik kodu kullanın. |
| Kargo | BasitKargo sahte gönderi ve SVG etiket döndürür. Etiket gerçek kargoda kullanılamaz; kurye çağrılmaz. |
| e-Fatura, SMS, muhasebe | Hazırlık ortamıyla aynı sahte sunucular yanıt verir; gerçek belge veya mesaj gönderilmez. |
| E-posta | Gönderilmez. Panel hesabını doğrulama bağlantısı yalnız bu ortamda ekranda açılır. |
| Pazaryerleri | Trendyol ve Hepsiburada sahte sunucuları kullanılır. Sahte sunucusu bulunmayan bağlantılar çalışmaz; gerçek sağlayıcıya geçiş yapılmaz. |
| AI asistanı | Kapalıdır. Panel formları ve API kullanılabilir. |

Sahte servislerin belleği yeniden başlatıldığında sıfırlanabilir. İşletmenizdeki PostgreSQL kayıtları
yeniden yayında korunur. Deneme ortamında webhook'lar gerçek adresinize gönderilir; özel/iç ağ adresleri
reddedilir. Genel internete açık HTTPS adresinizi [webhook rehberindeki](https://developer.siparis.app/webhook) adımlarla bağlayın;
imza doğrulaması, yeniden deneme ve yönlendirmeleri izlememe kuralları canlıyla aynıdır.
Değişiklikleri ayrıca [olay akışından](https://developer.siparis.app/olaylar) okuyabilirsiniz.

## Sınırlar ve kalıcılık

Bu küçük, ortak ortam yük testi için değildir. API, panel ve vitrin istekleri için IP başına dakikada
180 istek ve işletme başına dakikada 120 istek sınırı uygulanır; API’nin kendi sınırları ve kayıt/giriş
korumaları da geçerlidir. `429` yanıtında `Retry-After` kadar bekleyin.

Veriler kalıcıdır ama saklama veya yedekten geri getirme garantisi yoktur. Otomatik işletme silme yoktur.
Deneme verisi ve anahtarlar canlıya taşınmaz. Hazır olduğunuzda canlıda ayrı hesabınızdan `spk_live_`
anahtarı oluşturun ve API adresini `https://api.siparis.app/v1` yapın.