Geliştiriciler

Vitrin geliştirici portalı

Platformu üç yoldan genişletebilirsiniz: Storefront API ile kendi vitrininizi yazarak, tema paketiyle mağazanın görünümünü tasarlayarak ya da uygulama (modül) ile yeni bir entegrasyon ekleyerek.

Mimari, tek paragrafta

Ürün verisi merkezde yaşar; web mağaza, Trendyol ve Google Merchant aynı Channel soyutlamasının örnekleridir. Mağaza vitrini, alan adından mağazayı çözer, temanın bölüm listesini okur ve veriyi yalnızca Storefront API’den çeker. Tema için ayrı, kısayol bir sorgu yolu yoktur; sizin headless vitrininiz de yerleşik temalar da aynı uçları kullanır.

Hızlı başlangıç

TypeScript SDK’si Storefront API’nin ince bir istemcisidir. Önce alan adından mağazayı çözün, sonra dönen kiracı kimliğiyle istek atın.

import { StorefrontClient } from '@platform/sdk';

const API = 'https://api.ornek.com';
const store = await new StorefrontClient({ baseUrl: API }).resolve('www.magazaniz.com');

const shop = new StorefrontClient({ baseUrl: API, tenantId: store.tenantId });
const categories = await shop.categories();
const results = await shop.search(store.channelId, 'gömlek');

Temel kurallar

• Para hiçbir yerde kayan noktalı sayı değildir: tutarlar kuruş cinsinden tam sayıdır ({ amount: "129900", currency: "TRY" }).
• Tarihler her yerde UTC ve ISO 8601’dir.
• Hatalar Türkçe ve alan bazlıdır: { message, errors: [{ field, message }] }.
• Olay adları sürümlüdür: order.placed.v1. Şema değişirse yeni sürüm yayımlanır.
• Kiracının girdiği hiçbir metin ham HTML olarak çizilmez; temalar da bu kurala uyar.