Co zawiera katalog

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

441 217: pozycji łącznie
72 776: w aktualnych kolekcjach
306: marek
85 371: modeli
281 401: 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": "8056597843119",
      "brand": "RAY-BAN",
      "model": "RX3717V",
      "name": "RX3717V 2502 54",
      "color": "CLEAR",
      "size": "54",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 173,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119.jpg",
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119_1.jpg",
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119_2.jpg",
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119_3.jpg",
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056597843119_4.jpg"
      ]
    },
    {
      "ean": "8053672819762",
      "brand": "RAY-BAN",
      "model": "RB4195M",
      "name": "RB4195M F602H2 52",
      "color": "GREEN MIRROR SILVER POLARISED+",
      "size": "52",
      "gender": "MAN",
      "material": "PEEK",
      "rrp": 326,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762.jpg",
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762_1.jpg",
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762_2.jpg",
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762_3.jpg",
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8053672819762_4.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.