Deneme ortamında denemek

İlk bağlantınızı gerçek sipariş ve ödeme oluşturmadan deneme ortamında 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
Panel	sandbox.siparis.app/panel
Marka vitrini	`https://<marka>.sandbox.siparis.app`
API	`https://api.sandbox.siparis.app/v1`
Belgeler	developer.siparis.app

Deneme adresinde hesap açın. Canlı hesabınız burada geçmez. Gerçek müşteri veya kart bilgisi kullanmayın.
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.
İş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.
İş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.

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 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 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.