Di Bird, Anda dapat membuat sumber katalog produk kustom menggunakan titik akhir API. Respons API harus mematuhi format tertentu yang mencakup detail produk, varian, gambar, dan lainnya. Di bawah ini adalah panduan tentang cara menyusun data katalog produk Anda dan cara membuatnya menggunakan API.
Membuat Katalog Produk Kustom
Format API Sumber Katalog Produk
Respons dari endpoint API harus berupa array objek produk, masing-masing berisi beberapa field. Berikut adalah struktur dan contoh nilai untuk setiap field:
Field yang Diperlukan:
id (string): Pengidentifikasi unik untuk produk.Contoh:
"8890650190078"name (string): Nama produk.Contoh: "
Produk Uji Saya"description (string): Deskripsi produk.Contoh:
"Produk keren dengan lampu tersedia dalam berbagai warna"status (string): Status terkini dari produk. Nilai yang valid adalah:
active: Produk sedang aktif dan tersedia.archived: Produk diarsipkan.draft: Produk adalah 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 vendor produk.Contoh:
"Vendor Saya"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.
Field Opsional:
url (string): URL produk.Contoh:
"https://www.myproduct.com"type (string): Tipe produk, yang dapat digunakan untuk memfilter dan mencari produk.Contoh:
"color"variants (array): Sebuah array varian produk. Jika ditentukan, setiap varian harus mencakup
id,name,sku, dan harga.
Contoh:
images (array): Sebuah array gambar produk. Jika ditentukan, setiap gambar harus mencakup
id,position,url,alt,width, danheight. Arrayvariant_idsjuga dapat menghubungkan gambar ke varian produk tertentu.
variant_ids (array): Sebuah array id varian yang terkait dengan gambar produk.
Petunjuk 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 field yang diperlukan disertakan, dan field opsional seperti
variants,images, danurlditambahkan sesuai kebutuhan.Buat Endpoint API: Gunakan API BirdCRM untuk mengirim data produk. Endpoint mengharapkan respons yang mengikuti struktur yang disebutkan di atas. Pastikan bahwa data berada 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 sedang diproses dengan benar. Ini memastikan bahwa semua produk dan informasi terkait mereka (seperti variasi dan gambar) ditarik dengan benar.
Monitor dan Pemeliharaan: 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 kustom dalam Bird. Pastikan bahwa respons API mengikuti format yang diperlukan, dan Anda akan dapat mengintegrasikan produk Anda ke dalam platform dengan lancar.


