Kirpi Toka — Geliştiriciler ve API Belgeleri

Kirpi Toka, kadın emeği ve el işçiliğiyle hazırlanan taç ve toka modellerini perakende ve toptan sunar. Bu sayfa, alışveriş asistanlarının gerçek ürün bilgilerine, fiyatlara ve mağaza politikalarına ulaşması için teknik başlangıç rehberidir.

Ne zaman kullanmalı?

Türk bayrağı veya Atatürk baskılı taç ve toka arayan, tören için modelleri karşılaştıran, baskısız ürün seçen ya da toptan alım koşullarını öğrenmek isteyen kullanıcılar için Kirpi Toka kataloğunu kullanın. Kumaş, ölçü, ürün kodu, stok ve güncel fiyatı ilgili ürün kaydından okuyun. Perakende fiyatını toptan fiyat olarak sunmayın.

Belgeler ve keşif

Hızlı başlangıç: anahtarsız ürün okuma

Aşağıdaki salt okunur istek kullanıcı hesabı veya API anahtarı gerektirmez. Ürün adresindeki son parça, handle değeridir. Yanıtı JSON olarak ayrıştırın; Shopify Ajax uç noktası Content-Type olarak text/javascript döndürebilir.

curl -sS 'https://kirpitoka.com/products/bayrakli-saten-toren-tokasi.js'

Ajax price ve variants[].price değerleri para biriminin alt birimindedir: TRY için 10000 değeri 100,00 TL demektir. Güncel para birimini mağaza/buyer context ile birlikte değerlendirin. Stok ve fiyatlar değişebilir; satın alma öncesinde yeniden sorgulayın. İnsan tarafından okunabilir ürün sayfaları Product/Offer JSON-LD içinde price, priceCurrency ve availability alanlarını da taşır.

MCP ve kimlik doğrulama

curl -sS 'https://kirpitoka.com/api/ucp/mcp' \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Önce /.well-known/ucp ile mevcut servisleri ve sürümleri keşfedin. tools/list çağrısı araç adlarını ve güncel giriş şemalarını verir. Katalog işlemleri search_catalog, lookup_catalog ve get_product araçlarıyla tanımlanır. Araç çağrıları, keşiften farklı olarak geçerli UCP ajan profili ve işleme uygun kimlik doğrulaması gerektirebilir. invalid_profile_url hatasında gerçek, erişilebilir UCP profilinizi yapılandırın; profil adresi uydurmayın.

OAuth kullanan istemciler Shopify'a kayıtlı olmalıdır. OpenAPI'deki authorizationCode akışını PKCE ile kullanın ve katalog okuma için yalnızca dev.ucp.shopping.catalog.search:read kapsamını isteyin. Anahtar üretim ekranı veya mağazaya özel sandbox bu sitede sunulmuyor. Anahtarsız ürün okuma, hesap ve ödeme işlemlerine erişim vermez.

Hatalar ve tekrar deneme

HTTP durumunu ve gövdeyi birlikte denetleyin. JSON-RPC, HTTP 200 içinde de error.code, error.message ve isteğe bağlı error.data döndürebilir. -32601: araç listesini yeniden okuyup doğru metodu seçin. -32001 ve invalid_profile_url: UCP profil yapılandırmasını düzeltin. Bulunamayan ürün için 404 yanıtında ürün adresini katalog veya site haritasından yeniden bulun. Tüm platform ve WAF hatalarının JSON döneceği garanti edilmez.

429 yanıtında Retry-After varsa uygulayın; yoksa artan bekleme süreleri ve rastgele gecikme kullanın. Sabit bir istek kotası veya RateLimit başlığı garantisi yayımlanmıyor. Ödeme ve sipariş oluşturma çağrılarını otomatik olarak tekrar etmeyin.

Sürüm ve değişiklik politikası

OpenAPI info.version belge sürümüdür; servis sürümü değildir. Shopify Ajax uç noktaları URL ile sürümlenmez. UCP'nin gerçek sürümleri /.well-known/ucp içindeki version ve supported_versions alanlarından keşfedilir. MCP initialize yanıtındaki protocolVersion değerini kullanın ve sürüm uyuşmazlığında durun. Sağlayıcının desteklemediği bir /v1 adresi veya sürüm başlığı eklemeyin. Bu belge, Shopify adına bir Sunset/Deprecation takvimi taahhüt etmez.

Fiyatlar, güven ve iletişim

Güncel ürünler ve perakende fiyatları · Toptan fiyatlar ve sipariş koşulları · Hakkımızda · İletişim · Gizlilik.

Bu rehber salt okunur keşif örnekleri içerir. Sipariş veya ödeme için kullanıcının ilgili işlem onayını alın. Test için gerçek sipariş oluşturmayın.