Co zawiera katalog

Te liczby są czytane wprost z bazy i odświeżają się same — nie są wpisane w stronę.

430 386: pozycji łącznie
59 862: w aktualnych kolekcjach
305: marek
82 796: modeli
275 253: pozycji ze zdjęciami
324 546: pozycji soczewek kontaktowych

Katalog przechowuje także modele wycofane — są potrzebne, by rozpoznać stany magazynowe i dawne kolekcje. Każda pozycja ma własny status.

Jak pobrać dane

Dwie drogi dla różnych zespołów: wywołanie z własnego systemu albo plik, który otworzy każdy pracownik.

API REST

Do integracji ze sklepem, systemem magazynowym lub ofertami na marketplace’ach.

Filtry według marki, modelu, typu, płci, kształtu, materiału i dziesiątek innych pól
Paginacja kursorem — cały katalog pobierzesz bez luk i duplikatów
Strumień przyrostowy: pobierasz tylko to, co zmieniło się od ostatniej synchronizacji

Eksport do Excela

Dla tych, którym potrzebny jest plik, a nie integracja. Bez programisty.

Wybierasz marki, filtry i kolumny — zapisujesz zestaw jako szablon
Przed uruchomieniem widzisz, ile pozycji trafi do pliku
Duże eksporty przygotowują się w tle, a odnośnik pojawia się na koncie

Zdjęcia

Fotografie produktów na czystym tle, gotowe do witryny i marketplace’u.

W API — bezpośrednie odnośniki do zdjęć przy każdej pozycji
W eksporcie — osobne archiwum, uporządkowane według marek i modeli
W archiwum jest spis wiążący każdy kod kreskowy z jego plikami

Jak wygląda odpowiedź

Prawdziwe dane z katalogu, a nie przykład z dokumentacji.

Zapytanie

GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2

Odpowiedź

{
  "data": [
    {
      "ean": "805289003472",
      "brand": "RAY-BAN",
      "model": "RB3136",
      "name": "RB3136 001 58",
      "color": "GOLD",
      "size": "58",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/805289003472.png"
      ]
    },
    {
      "ean": "8056262017838",
      "brand": "RAY-BAN",
      "model": "RX5425D",
      "name": "RX5425D 2012 54",
      "color": "TORTOISE",
      "size": "54",
      "gender": "UNISEX",
      "material": "ACETATE",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056262017838.jpg"
      ]
    }
  ],
  "meta": {
    "returned": 2,
    "cursor": null
  }
}

Zestaw pól ustalasz sam: jeśli potrzebujesz tylko kodu kreskowego, ceny i odnośnika do zdjęcia, odpowiedź będzie zawierać dokładnie to. Pełną listę pól zwraca /v1/meta — to najwygodniejszy punkt wyjścia do budowy integracji.

Częste pytania

Czy katalog zawiera stany magazynowe?

Nie. Katalog to dane referencyjne: atrybuty, zdjęcia, kody kreskowe i ceny sugerowane. Dostępność żyje w innym systemie i nie wchodzi w skład tych danych. Mówimy o tym od razu, żeby oczekiwania się zgadzały.

Jakie ceny udostępniacie?

Sugerowane ceny detaliczne — te, po których marka proponuje sprzedawać. Cen zakupu nie przekazujemy ani przez API, ani w eksportach.

Czy mogę używać zdjęć na własnej stronie?

Tak, to najczęstszy powód sięgania po katalog. API zwraca bezpośrednie odnośniki do zdjęć, a eksport dostarcza archiwum plików wraz ze spisem.

Jak często aktualizowane są dane?

Katalog rośnie na bieżąco, w miarę napływu danych od marek. API ma metodę zwracającą tylko zmiany od wskazanej daty — nie trzeba pobierać wszystkiego od nowa.

Jak zapłacić?

Na razie wystawiamy fakturę: płatności kartą na stronie jeszcze nie ma. Gdy się pojawi, obecni klienci nie będą musieli nic zmieniać.

Czy są też soczewki kontaktowe?

Tak, w osobnej sekcji: krzywizna bazowa, moc, cylinder, oś, addycja, opakowanie i cena. Zdjęć soczewek w bazie nie ma — niewiele by wnosiły.