Hızlı Sanal Market API

Hızlı Sanal Market, TEY Bilişim'in e-ticaret altyapısıdır. Hızlı Sanal Market API ile mağazanızı muhasebe/ERP, depo (WMS), kargo ya da bayi sistemlerinize bağlayabilirsiniz. API JSON ile çalışan bir REST arayüzüdür. Her mağaza kendi API anahtarını yönetim panelinden oluşturur.

API ile neler yapılır?

  • Ürünler: Ürünleri listeleme, yeni ürün açma, ürün bilgilerini güncelleme (Ürün Servisleri)
  • Stok ve fiyat: Tek ürünün stoğunu güncelleme ya da tek istekte 1.000 ürünün stok ve fiyatını barkod veya stok kodu ile güncelleme (Toplu Stok ve Fiyat)
  • Kategori ve marka: Listeleme ve eksik olanları açma (Kategori ve Marka)
  • Siparişler: Yeni ve değişen siparişleri çekme; hazırlanıyor, kargoda, teslim edildi, iptal ve iade durumlarını mağazaya geri yazma (Sipariş Servisleri)
  • Sipariş bildirimi: Ödemesi alınan siparişleri kendi adresinize anında POST ettirme (Sipariş Bildirimi)

Temel bilgiler

Konu Değer
API adresi https://api.hizlisanalmarket.com/api/v1
Veri biçimi JSON (UTF-8). Alan adları camelCase yazılır (stockQuantity, orderNumber).
Kimlik doğrulama Authorization: Bearer hm_sk_... (Kimlik Doğrulama)
Hangi pakette? Profesyonel, Kurumsal ve Premium
İstek sınırı Her anahtar için dakikada 60, günde 10.000 istek (Limitler ve Hatalar)
Tarih biçimi ISO 8601, UTC. Örnek: 2026-10-01T00:00:00Z
Fiyatlar KDV dahil, Türk lirası

Mağaza bilgisi isteğe eklenmez. Hangi mağazaya bağlanıldığı API anahtarından anlaşılır.

İlk istek

API anahtarınızı oluşturduktan sonra ürün listesinin ilk sayfasını şöyle çekebilirsiniz:

curl "https://api.hizlisanalmarket.com/api/v1/products?page=1&pageSize=5" \
  -H "Authorization: Bearer hm_sk_9e27c4d1a8b54f0e93d6a7c2e1f8b0d4c3a2e9f1"

Anahtar gönderilmezse ya da geçersizse yanıt 401 olur:

{ "error": "Geçersiz API key.", "code": "INVALID_API_KEY" }

Test ortamı

Ayrı bir test sunucusu yoktur. Denemelerinizi iki yoldan biriyle yapabilirsiniz:

  • hizlisanalmarket.com/demo adresinden 14 günlük Premium deneme mağazası isteyin. Talebiniz onaylanınca mağaza açılır ve API erişimi hazır olur.
  • Kendi mağazanızda isActive: false ile taslak ürünler açarak deneyin. Taslak ürünler vitrinde görünmez.

Opencart dönemine ait ws_*.php servisleri ile panel.teybilisim.com/entegrasyon ve apitest.teybilisim.com adresleri Hızlı Sanal Market'te kullanılmaz. Yeni entegrasyonlar bu dokümandaki /api/v1 uçlarını kullanmalıdır.

Mağazanızı Trendyol, Hepsiburada, N11 ve Çiçeksepeti gibi pazaryerlerine bağlamak için API yazmanıza gerek yoktur. Yönetim panelindeki Pazaryeri Entegrasyonu (TEY Entegrasyon) bu bağlantıyı hazır olarak sunar.

Destek

Sorularınız için bilgi@teybilisim.com adresine yazabilirsiniz. Hata bildirirken isteğin adresini, saatini ve yanıttaki code değerini ekleyin. API anahtarınızı e-postaya yazmayın.