Cara Menghubungkan Layanan Pemasok dengan Kartu Panel SMM melalui API
Mengapa katalog pemasok perlu dipisahkan dari etalase panel
API pemasok biasanya mengembalikan katalog teknis: ID eksternal, nama, harga, batas, status, dan parameter pesanan. Di panel SMM, posisi yang sama harus masuk ke struktur yang mudah dipahami klien: platform, jenis promosi, geografi, format tautan, kualitas audiens, atau kecepatan peluncuran.
Jika katalog eksternal ditampilkan tanpa diproses, etalase akan menampilkan nama teknis, duplikat, dan posisi yang tidak tersedia. Pemetaan memisahkan logika pengadaan dan kartu klien. Satu layanan pemasok tidak harus menjadi layanan terpisah di panel.
Data apa yang perlu diambil melalui API
Simpan data asli pemasok secara terpisah dari pengaturan etalase. ID eksternal tidak boleh diganti dengan pengenal internal panel: ID ini diperlukan untuk membuat pesanan, mendapatkan status, membatalkan, dan menelusuri kesalahan. Berguna juga untuk menyimpan waktu sinkronisasi terakhir dan respons API lengkap atau cuplikannya.
- Pengenal pemasok dan ID eksternal layanan.
- Nama, deskripsi, dan kategori eksternal.
- Harga beli, mata uang, dan satuan perhitungan.
- Volume minimum, maksimum, dan langkah kuantitas.
- Status ketersediaan, sisa, dan tanda penghentian sementara.
- Persyaratan tautan, login, publikasi, komentar, dan geografi.
- Tanda peluncuran manual, pembatalan, peluncuran ulang, dan pemenuhan sebagian.
Kekurangan impor otomatis adalah pemasok menamai bidang yang sama dengan cara berbeda dan terkadang mengirimkan data yang tidak lengkap. Nama layanan tidak cocok untuk hubungan yang stabil: nama dapat diubah tanpa mengubah ID eksternal.
Contoh permintaan dan respons katalog layanan
Format API bergantung pada pemasok, tetapi logikanya biasanya sama: panel mengirimkan kunci akses dan parameter halaman, lalu menerima array layanan dalam respons. Misalnya, permintaan katalog dengan kursor dapat terlihat seperti ini:
GET /api/services?cursor=eyJwYWdlIjoyfQ
Respons API bersyarat:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
Bidang respons tidak boleh langsung ditulis ke kartu etalase. Bidang tersebut harus diverifikasi terlebih dahulu, disimpan di katalog pemasok, dan dipetakan ke aturan internal. Kekurangan bekerja hanya dengan kartu yang sudah jadi adalah impor dapat menimpa nama klien, deskripsi, atau kategori yang dipilih secara manual.
Tentukan dulu struktur kategori di panel
Sebelum impor, tentukan taksonomi panel. Tingkat atas biasanya menjelaskan platform, tingkat berikutnya adalah tindakan: pengikut, tayangan, reaksi, komentar, penonton siaran, atau format lain. Di dalamnya, layanan dapat dibagi berdasarkan geografi, jenis audiens, kecepatan, dan ketentuan kompensasi.
Untuk setiap kategori, tentukan atribut wajib. Untuk tayangan, ini bisa berupa jenis tautan dan format konten; untuk pengikut, platform, geografi, dan jenis profil yang diizinkan. Kekurangan struktur yang terlalu detail adalah katalog menjadi lebih sulit dipelihara, dan layanan yang mirip mulai berbeda hanya pada nuansa internal.
Simpan hubungan pemasok dan etalase secara terpisah
Keterkaitan antara layanan pemasok dan kartu panel harus disimpan dalam tabel atau entitas terpisah. Di dalamnya diperlukan pemasok, ID eksternal, kartu internal, kategori, aturan harga, prioritas rute, status publikasi, dan tanggal verifikasi terakhir yang berhasil.
Skema seperti ini memungkinkan penggantian pemasok tanpa mengubah URL kartu dan tanpa kehilangan riwayat pesanan. Contoh baris pemetaan dalam JSON:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Hubungan dapat berbeda-beda, tetapi tentukan aturan pembaruan untuk masing-masing terlebih dahulu.
- Satu layanan pemasok — satu kartu, jika parameternya unik dan formulir pesanannya unik.
- Beberapa layanan dari pemasok berbeda — satu kartu, jika keduanya kompatibel dalam persyaratan dan ketentuan.
- Satu layanan pemasok — beberapa kartu, jika etalase memisahkannya berdasarkan bahasa, segmen, atau cara penjualan.
Menggabungkan beberapa pemasok dalam satu kartu memiliki kekurangan: kecepatan, ketersediaan, dan ketentuan pemenuhan aktual dapat berbeda. Jangan menggabungkan rute dengan format tautan, batas, atau bidang wajib yang berbeda.
Impor katalog halaman demi halaman
Pemasok dapat menyajikan katalog dalam halaman melalui nomor, offset, atau kursor. Respons pertama belum tentu berisi semua layanan. Mintalah halaman berikutnya selama API mengirimkan kursor, tautan lanjutan, atau tanda jelas lain bahwa data masih ada.
Pada paginasi berbasis kursor, pemrosesan berlangsung seperti ini: panel menerima halaman, menyimpan semua layanan, menandainya sebagai ditemukan dalam siklus saat ini, lalu baru beralih ke kursor berikutnya. Jika bidang next_cursor tidak ada, penelusuran dianggap selesai.
- Buat pengenal untuk siklus sinkronisasi saat ini.
- Minta halaman pertama dan simpan layanan yang diterima.
- Untuk setiap layanan, perbarui bidang last_seen_sync dengan pengenal siklus.
- Simpan kursor halaman berikutnya sebelum menjalankan permintaan berikutnya.
- Setelah berhasil menelusuri semua halaman, bandingkan katalog dengan siklus saat ini.
Kekurangan pemuatan halaman secara berurutan adalah impor penuh bisa memakan waktu lebih lama. Permintaan paralel mempercepat proses, tetapi meningkatkan risiko terkena batas API atau menerima halaman dalam keadaan katalog yang berbeda.
Jangan membuat duplikat saat sinkronisasi ulang
Untuk mencari layanan yang sudah ada, gunakan kunci gabungan: pengenal pemasok dan ID eksternal layanan. Pada setiap impor ulang, cari catatan berdasarkan pasangan ini terlebih dahulu, lalu perbarui bidang teknis. Buat catatan baru hanya jika kunci tersebut tidak ada.
Jangan gunakan nama, harga, atau kategori untuk deduplikasi. Dua layanan berbeda dapat memiliki nilai yang sama, dan pemasok dapat mengganti nama posisi tanpa mengubah ID eksternal. Untuk hubungan dengan etalase juga diperlukan kontrol unik: rute yang sama tidak boleh muncul dua kali setelah tugas dijalankan ulang.
Berguna untuk membatasi keunikan di tingkat basis data: supplier_id + external_service_id untuk katalog pemasok dan supplier_id + external_service_id + showcase_card_id untuk pemetaan. Kekurangan batasan ketat adalah jika terjadi kesalahan pada hubungan lama, hubungan itu harus diperbaiki secara eksplisit, bukan dengan membuat catatan baru di atasnya.
Cara menemukan layanan yang dihapus dan hilang
Layanan hanya dapat dianggap hilang setelah penelusuran semua halaman berhasil sepenuhnya. Jika sinkronisasi berhenti karena kesalahan, batas permintaan, atau API tidak tersedia, posisi yang tidak ada di bagian katalog yang sudah dimuat tidak boleh ditandai sebagai dihapus.
Setelah impor selesai, temukan layanan dari pemasok ini yang last_seen_sync-nya tidak sama dengan pengenal siklus saat ini. Layanan tersebut diberi status “tidak ditemukan” atau “diarsipkan”, dinonaktifkan dari pesanan baru, dan dikirim untuk pemeriksaan. ID eksternal, riwayat perubahan, dan hubungan dengan pesanan tetap disimpan.
Layanan yang hilang harus diarsipkan, bukan dihapus. Pemasok dapat mengembalikannya ke katalog nanti, mengubah filter respons, atau menyembunyikan posisi untuk sementara. Hubungan arsip dapat dipulihkan pada impor berikutnya jika ID eksternal yang sama muncul lagi.
Apa yang harus dilakukan saat ID eksternal layanan berubah
Jika pemasok membuat layanan baru sebagai pengganti layanan lama, ID eksternal baru tidak boleh otomatis dianggap sebagai kelanjutan dari yang lama. Bahkan dengan nama dan harga yang sama, persyaratan pesanan, geografi, jenis audiens, atau ketentuan kompensasi posisi tersebut dapat berubah.
Pindahkan hubungan lama ke arsip, tarik rutenya dari penjualan, dan simpan untuk pesanan lama. Impor layanan baru sebagai catatan terpisah. Kemudian buat pemetaan baru secara manual atau berdasarkan aturan yang aman, jika parameter teknisnya sepenuhnya kompatibel.
Pencocokan otomatis berdasarkan nama dapat mempercepat pekerjaan, tetapi kekurangannya adalah risiko mengirim pesanan ke layanan lain dengan ketentuan yang tidak sesuai. Untuk perubahan ID, lebih baik menggunakan status “perlu pemeriksaan” daripada mengganti rute secara diam-diam.
Atur pemetaan berdasarkan bidang teknis yang stabil
Distribusi layanan otomatis sebaiknya dibangun berdasarkan serangkaian bidang: platform, jenis layanan, geografi, format tautan, volume minimum, parameter tambahan, dan status. Misalnya, layanan dapat masuk ke kategori tayangan berdasarkan geo jika API mengirimkan nilai platform, jenis promosi, dan negara yang kompatibel.
Jika pemasok memerlukan komentar, daftar profil, atau peluncuran manual, jangan publikasikan rute dalam formulir pesanan standar. Gunakan kartu terpisah dengan bidang yang diperlukan atau biarkan layanan tersembunyi sampai integrasi selesai diperbaiki.
Nama hanya boleh digunakan sebagai atribut tambahan. Kekurangan aturan seperti ini adalah pemasok dapat mengubah frasa, menambahkan singkatan, atau menggunakan ejaan lain. Ikat rute kritis ke ID eksternal dan parameter respons yang dapat diverifikasi.
Pisahkan data API dan pengaturan kartu
Impor tidak boleh sepenuhnya menimpa kartu etalase. Harga beli, batas, ketersediaan, dan parameter teknis biasanya diperbarui dari pemasok. Nama untuk klien, deskripsi, visibilitas, urutan tampilan, dan aturan markup tetap menjadi pengaturan internal panel.
Untuk setiap bidang, tetapkan sumber kebenaran. Misalnya, volume minimum diambil dari API, nama klien dari panel, dan harga etalase dihitung berdasarkan aturan internal dari biaya beli. Tanpa pemisahan seperti ini, sinkronisasi dapat menghapus deskripsi yang diedit secara manual atau mengubah kategori berdasarkan nama eksternal.
Periksa perubahan harga dan parameter
Jika pemasok mengubah harga, hitung ulang harga etalase berdasarkan aturan kartu dan periksa mata uang, komisi, serta margin yang diizinkan. Jika harga tidak ada, mata uang tidak diketahui, atau ketentuan berubah secara signifikan, lebih baik ubah rute ke status pemeriksaan.
Saat minimum, maksimum, atau langkah kuantitas berubah, perbarui formulir pesanan. Jika formulir tidak mendukung batasan baru, tarik rute dari penjualan. Jika tidak, klien akan membuat pesanan yang akan ditolak pemasok setelah dikirim.
Jika format tautan, bidang wajib, jenis layanan, atau cara peluncuran berubah, blokir pesanan baru hingga pemeriksaan manual. Kekurangan pemblokiran ketat adalah sebagian kartu akan sementara hilang dari etalase, tetapi ini lebih aman daripada menerima pesanan yang tidak kompatibel.
Tangani kesalahan API dan batas permintaan
Kesalahan pada satu permintaan tidak boleh otomatis menonaktifkan seluruh katalog. Pisahkan kesalahan otorisasi, permintaan tidak valid, ketidaktersediaan sementara, dan pembatasan frekuensi permintaan. Setiap kelompok memerlukan skenario penanganan tersendiri.
- Pada kesalahan otorisasi, hentikan pesanan baru untuk pemasok ini dan periksa akses.
- Pada kesalahan format permintaan, simpan respons API dan perbaiki integrasi tanpa pengulangan tanpa henti.
- Pada kesalahan sementara, ulangi permintaan dengan jeda yang meningkat.
- Pada pembatasan frekuensi, simpan kursor saat ini dan jadwalkan ulang tugas.
Jangan tandai layanan sebagai hilang sampai sinkronisasi yang tertunda berhasil diselesaikan. Kekurangan pengulangan agresif adalah batas permintaan dapat lebih cepat habis dan katalog tetap usang untuk waktu yang lebih lama.
Pertahankan rute untuk pesanan aktif
Status layanan dan status pesanan adalah entitas yang berbeda. Layanan dapat hilang dari katalog untuk klien baru, tetapi pesanan lama untuk layanan tersebut masih diproses. Pengarsipan kartu atau rute tidak boleh menghentikan polling status pesanan yang sudah dibuat.
Untuk setiap pesanan, simpan ID eksternal layanan, ID eksternal pesanan, parameter yang dikirim, biaya beli pada saat peluncuran, dan riwayat status. Jika pemasok melaporkan pemenuhan sebagian, pembatalan, atau kesalahan, tangani situasi sesuai aturan panel: pengembalian dana, kompensasi, peluncuran ulang, atau pemeriksaan manual.
Kekurangan penyimpanan cuplikan parameter pesanan adalah diperlukan lebih banyak ruang dan skema data yang rapi. Tanpa cuplikan seperti itu, tidak mungkin menetapkan dalam ketentuan apa pesanan dikirim jika pemasok kemudian mengubah layanan.
Uji pemetaan sebelum memublikasikan kartu
Setelah pengaturan, uji jalur lengkap: pembuatan pesanan di panel, pemilihan rute, pengiriman ke pemasok, penyimpanan ID eksternal, penerimaan status, pembatalan, dan penanganan pemenuhan sebagian. Uji kelompok layanan dengan batas, tautan, dan bidang wajib yang berbeda.
Secara terpisah, simulasikan impor ulang, perubahan harga, hilangnya layanan setelah penelusuran penuh yang berhasil, kesalahan di tengah paginasi, dan pembatasan frekuensi permintaan. Ini akan menunjukkan apakah panel mengarsipkan rute yang berfungsi akibat pemuatan katalog yang tidak lengkap.
Berikan perhatian khusus pada layanan manual dan posisi dengan komentar. Kekurangannya adalah formulir standar panel sering kali tidak mengirimkan semua data yang diharapkan pemasok. Untuk itu diperlukan templat pesanan terpisah atau status tersembunyi sampai integrasi API selesai diperbaiki.
Last Articles
Apa yang Berubah dalam Desain dan Fungsionalitas Kami telah memperbarui situs agar bekerja lebih cepat dan nyaman. Perubahan utama menyangkut antarmu..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. Gunakan kode promo "December2025" untuk diskon 15% untuk semua penonton kami2. Kami telah menurunkan harga dasar untuk konfigurator dan kategori pe..
Layanan Twitch adalah bekerja dengan stabil, jadi kami siap bekerja sama dengan regu, reseller, pemilik layanan, pemilik bot, dan banyak lainnya.K..
Kami telah sepenuhnya memperbarui layanan penampil Twitch kami, dan sekarang sudah tersedia bekerja dengan stabil. Kami hanya menggunakan alamat I..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
Karena popularitas besar layanan kemitraan dan program rujukan, kami telah membuat tabel kerja sama. Intinya sangat sederhana: lebih banyak pemirsa la..
Layanan Kami untuk Streamer

Shopee
Layanan Kami untuk Pembuat Konten









