Niestandardowy katalog produktów Source
Wprowadź swój własny katalog produktów
W Bird możesz stworzyć niestandardowe źródło katalogu produktów za pomocą punktu końcowego API. Odpowiedź API musi być zgodna z określonym formatem, który zawiera szczegóły produktów, warianty, obrazy i więcej. Poniżej znajduje się przewodnik, jak zorganizować dane katalogu produktów i jak go utworzyć za pomocą API.
Tworzenie Custom Product Catalog
Product Catalog Source API Format
Odpowiedź z punktu końcowego API powinna być tablicą obiektów produktów, z których każdy zawiera kilka pól. Oto struktura i przykładowe wartości dla każdego pola:
Wymagane Pola:
id (string): Unikalny identyfikator produktu. Przykład:
"8890650190078"
name (string): Nazwa produktu. Przykład: "
My Test Product"
description (string): Opis produktu. Przykład:
"A cool product with lights available in different colors"
status (string): Aktualny status produktu. Dostępne wartości to:
active
: Produkt jest dostępny.archived
: Produkt jest zarchiwizowany.draft
: Produkt jest szkicem. Przykład:"active"
created_at (string): Data i czas utworzenia produktu, w formacie ISO-8601. Przykład:
"2022-05-25T10:55:16+02:00"
updated_at (string): Data i czas ostatniej aktualizacji produktu, w formacie ISO-8601. Przykład:
"2022-05-25T10:55:16+02:00"
published_at (string): Data i czas publikacji produktu, w formacie ISO-8601. Przykład:
"2022-05-25T10:55:16+02:00"
vendor (string): Nazwa dostawcy produktu. Przykład:
"My Vendor"
deleted_at (string): Data i czas usunięcia produktu (jeśli dotyczy), w formacie ISO-8601. Przykład:
"2022-05-25T10:55:16+02:00"
lub pusty ciąg""
jeśli produkt nie został usunięty.
Pola Opcjonalne:
url (string): URL produktu. Przykład:
"https://www.myproduct.com"
type (string): Typ produktu, który może być używany do filtrowania i wyszukiwania produktów. Przykład:
"color"
variants (array): Tablica wariantów produktu. Jeśli określone, każdy wariant musi zawierać
id
,name
,sku
i cenę.
Przykład:
images (array): Tablica obrazów produktu. Jeśli określone, każdy obraz musi zawierać
id
,position
,url
,alt
,width
iheight
. Tablicavariant_ids
może również łączyć obrazy z określonymi wariantami produktu.
variant_ids (array): Tablica identyfikatorów wariantów powiązanych z obrazem produktu.
Instrukcje krok po kroku dotyczące tworzenia źródła katalogu produktów Custom
Przygotuj Swoje Dane: Sformatuj odpowiedź swojego katalogu produktów zgodnie z powyższą strukturą. Upewnij się, że wszystkie wymagane pola są uwzględnione, a opcjonalne pola jak
variants
,images
iurl
są dodane w razie potrzeby.Utwórz Punkt Końcowy API: Użyj BirdCRM API do wysłania danych o produktach. Punkt końcowy oczekuje na odpowiedź zgodną z powyższą strukturą. Upewnij się, że dane są w prawidłowym formacie JSON.
Przetestuj Punkt Końcowy: Przed zintegrowaniem źródła katalogu produktów z twoim obiegiem pracy ważne jest, aby przetestować punkt końcowy API i zweryfikować, że dane są przetwarzane prawidłowo. To zapewnia, że wszystkie produkty i ich powiązane informacje (jak rodzaje i obrazy) są pobierane poprawnie.
Monitoruj i Utrzymuj: Gdy źródło katalogu produktów zostało utworzone, możesz monitorować jego wydajność za pomocą funkcji raportowania BirdCRM. Jeśli potrzebujesz zaktualizować jakiekolwiek szczegóły produktu lub dodać nowe produkty, po prostu zaktualizuj dane za pomocą API.
Przykład Odpowiedzi API:
Postępując zgodnie z tymi krokami, możesz stworzyć i zarządzać niestandardowym źródłem katalogu produktów wewnątrz Bird. Upewnij się, że odpowiedź API spełnia wymagany format, a będziesz mógł płynnie zintegrować swoje produkty na platformie.