Sumber Katalog Produk Kustom
Masukkan katalog produk Anda sendiri
Di Bird, Anda dapat membuat sumber katalog produk kustom menggunakan endpoint API. Respons API harus mengikuti format khusus yang mencakup detail produk, varian, gambar, dan lain-lain. Di bawah ini adalah panduan tentang cara menyusun data katalog produk Anda dan cara membuatnya menggunakan API.
Membuat Custom Product Catalog
Product Catalog Sumber API Format
Respon dari endpoint API harus berupa array dari objek produk, masing-masing berisi beberapa bidang. Berikut adalah struktur dan contoh nilai untuk setiap bidang:
Bidang Wajib:
id (string): Pengenal unik untuk produk. Contoh:
"8890650190078"
name (string): Nama produk. Contoh: "
My Test Product"
description (string): Deskripsi produk. Contoh:
"Sebuah produk keren dengan lampu tersedia dalam berbagai warna"
status (string): Status produk saat ini. Nilai yang valid adalah:
active
: Produk saat ini tayang dan tersedia.archived
: Produk diarsipkan.draft
: Produk dalam bentuk draft. Contoh:"active"
created_at (string): Tanggal dan waktu ketika produk dibuat, dalam format ISO-8601. Contoh:
"2022-05-25T10:55:16+02:00"
updated_at (string): Tanggal dan waktu ketika produk terakhir diperbarui, dalam format ISO-8601. Contoh:
"2022-05-25T10:55:16+02:00"
published_at (string): Tanggal dan waktu ketika produk diterbitkan, dalam format ISO-8601. Contoh:
"2022-05-25T10:55:16+02:00"
vendor (string): Nama penjual produk. Contoh:
"My Vendor"
deleted_at (string): Tanggal dan waktu ketika produk dihapus (jika berlaku), dalam format ISO-8601. Contoh:
"2022-05-25T10:55:16+02:00"
atau string kosong""
jika produk belum dihapus.
Bidang Opsional:
url (string): URL produk. Contoh:
"https://www.myproduct.com"
type (string): Jenis produk, yang dapat digunakan untuk pemfilteran dan pencarian produk. Contoh:
"color"
variants (array): Array dari varian produk. Jika ditentukan, setiap varian harus mencakup
id
,name
,sku
, dan harga.
Contoh:
images (array): Array dari gambar produk. Jika ditentukan, setiap gambar harus mencakup
id
,position
,url
,alt
,width
, danheight
. Arrayvariant_ids
juga dapat menghubungkan gambar ke varian produk tertentu.
variant_ids (array): Array dari id varian yang berhubungan dengan gambar produk.
Instruksi Langkah-demi-Langkah untuk Membuat Sumber Katalog Produk Kustom
Siapkan Data Anda: Format respons katalog produk Anda sesuai dengan struktur yang diuraikan di atas. Pastikan semua bidang yang diperlukan disertakan, dan bidang opsional seperti
variants
,images
, danurl
ditambahkan sesuai kebutuhan.Buat API Endpoint: Gunakan BirdCRM API untuk mengirim data produk. Endpoint ini mengharapkan respons yang sesuai dengan struktur yang disebutkan di atas. Pastikan data dalam format JSON yang valid.
Uji Endpoint: Sebelum mengintegrasikan sumber katalog produk ke dalam alur kerja Anda, penting untuk menguji endpoint API untuk memverifikasi bahwa data diproses dengan benar. Ini memastikan bahwa semua produk dan informasi terkaitnya (seperti varian dan gambar) ditarik dengan benar.
Pantau dan Pertahankan: Setelah sumber katalog produk dibuat, Anda dapat memantau kinerjanya melalui fitur pelaporan BirdCRM. Jika Anda perlu memperbarui detail produk atau menambahkan produk baru, cukup perbarui data menggunakan API.
Contoh Respons API:
Dengan mengikuti langkah-langkah ini, Anda dapat membuat dan mengelola sumber katalog produk khusus dalam Bird. Pastikan bahwa respons API memenuhi format yang diperlukan, dan Anda akan dapat mengintegrasikan produk Anda ke dalam platform dengan lancar.