Tryoshop Inbound Entegrasyonu

Bu doküman, Tryoshop.com sitesine dışarıdan ürün çekerek bu ürünlerin işlenmesini kapsar.

API gereksinimleri

• JSON formatında yanıt vermelidir.
• 5000 ms altında yanıt vermelidir.
• Yanıt boyutu aşırı büyük olmamalı; gerekirse sıkıştırma kullanılmalıdır.
• Ürün görsellerinin bağlantıları (URL) zaman içinde değişmemelidir.
• Ürün görselleri, dış sistem tarafından boyut olarak optimize edilmelidir.
• Tarafımıza HTTPS ile güvenli bir URL iletilmelidir.
• İstekler tercihen POST olmalıdır; GET isteklerinde önbellek sorunu yaşanabilir.

Senkronizasyon yöntemleri

1. Tek API ile çalışma

Tek bir yanıt hem ürün hem de kategori eşleştirmesini sağlar.

[
  {
    "productId": "ürün id",
    "productName": "ürün adı",
    "brand": "marka",
    "categoryName": "kategori adı",
    "sellingPrice": "satış fiyatı",
    "discountPrice": "indirimli fiyat (boş veya 0 ise dikkate alınmaz)",
    "description": "ürün açıklaması",
    "shortDescription": "kısa açıklama",
    "attributes": [
      { "attributeName": "nitelik adı", "attributeValue": "nitelik değeri" }
    ],
    "variants": [
      { "eanCode": "ean bilgisi", "sizeName": "beden bilgisi", "quantity": "stok miktarı" }
    ],
    "imageUrls": ["ürün resim url'leri"]
  }
]

2. Kategori ve ürün API’lerinin ayrı çalışması

Kategori listesi ile kategori bazında ürün getiren ayrı URL’ler gerekir. Alternatif olarak bir ürün arama URL’si iletilirse, aranan ürünün hangi kategoride olduğu tespit edilebilir.

Kategori API yanıtı:

{
  "success": true,
  "totalCategories": "count bilgisi",
  "categories": [
    {
      "CategoryId": "sistemdeki kategori id",
      "CategoryName": "kategori adı",
      "ProductCount": "ürün sayısı",
      "SampleImages": ["örnek ürün resimleri"],
      "Description": "kategori açıklaması"
    }
  ]
}

Ürün API yanıtı:

{
  "success": true,
  "products": [
    {
      "productId": "ürün id",
      "productUrl": "ürün orijinal url",
      "productName": "ürün adı",
      "productDescription": "ürün açıklaması",
      "brand": "marka",
      "sellingPrice": "satış fiyatı",
      "discountPrice": "indirimli fiyat (boş veya 0 ise dikkate alınmaz)",
      "imageUrls": ["ürün resim url'leri"],
      "attributes": [
        { "attributeName": "nitelik adı", "attributeValue": "nitelik değeri" }
      ],
      "variants": [
        { "eanCode": "ean bilgisi", "sizeName": "beden bilgisi", "quantity": "stok miktarı" }
      ]
    }
  ]
}

Tekil ürün sorgulama servisi

Her iki yöntemde de gereklidir. Sisteminizden alınan productId ile sorgulama yapılır; bunun için bir API URL’si iletilmelidir.

{
  "success": true,
  "product": {
    "productId": "ürün id",
    "productUrl": "ürün orijinal url",
    "productName": "ürün adı",
    "productDescription": "ürün açıklaması",
    "brand": "marka",
    "sellingPrice": "satış fiyatı",
    "discountPrice": "indirimli fiyat (boş veya 0 ise dikkate alınmaz)",
    "imageUrls": ["ürün resim url'leri"],
    "attributes": [
      { "attributeName": "nitelik adı", "attributeValue": "nitelik değeri" }
    ],
    "variants": [
      { "eanCode": "ean bilgisi", "sizeName": "beden bilgisi", "quantity": "stok miktarı" }
    ]
  }
}