MerchandAise platform pengembang
Hubungkan alur kerja Anda ke MerchandAise.
Temukan dokumentasi API dan spesifikasi OpenAPI untuk alur kerja barang dagangan khusus. Hubungkan situs web, komunitas, operasi pemasok, atau akun perusahaan ke informasi desain, penawaran harga, dan pemesanan bersama.
Pilih koneksi yang dibutuhkan proyek Anda
Gunakan referensi di bawah ini untuk mengevaluasi titik akhir, format permintaan, dan persyaratan otorisasi. Spesifikasi publik mendukung perencanaan dan pembuatan klien; akses operasional bergantung pada API, akun, dan lingkungan.
Dimana MerchandAise memproses transaksi pembeli, Hutter Products GmbH adalah penjual yang mengontrak dan Merchant of Record dengan merek MerchandAise. Identitas pemasok dan detail kontak tetap dirahasiakan kecuali jika pengungkapan diperlukan, dan produksi masih memerlukan persetujuan pratinjau desain digital, konfirmasi kemampuan produksi, pemeriksaan teknis wajib, dan persetujuan sampel yang berlaku untuk pesanan yang diterima secara pasti.
01 — Kontrak
API dan permukaan integrasi
01
dokumen API & OpenAPI
Temukan referensi API untuk sesi desain dan perkakas asisten, lalu pilih kontrak komunitas, pemasok, atau perusahaan untuk alur kerja Anda.
Panduan implementasi
Baca dokumen perkakas asistenKontrak mesin
Perkakas asisten OpenAPI JSON/api/docs/openapi.jsonReferensi publik untuk API asisten dan perkakas. Akses produksi dan operasi yang memengaruhi pesanan masih memerlukan otorisasi yang berlaku.
02
API Komunitas
Hubungkan situs web klub atau komunitas ke informasi komunitas publik, pengiriman desain, pemungutan suara, dan penyerahan persetujuan pesanan.
- Apa yang tercakup dalam kontrak
- Konteks komunitas publik, postingan dan pemungutan suara desain, publikasi daftar, pesanan yang tertunda, dan persetujuan atau penolakan pemilik komunitas.
- Sebuah titik awal yang praktis
- Baca konteks komunitas publik untuk situs web klub. Kemudian petakan tindakan mana yang memerlukan sesi anggota atau izin pemilik sebelum menambahkan pengiriman desain atau penyerahan pembayaran.
- Akses
- Spesifikasinya bersifat publik. Pembacaan publik, tindakan anggota, dan operasi khusus pemilik memiliki persyaratan otorisasi yang berbeda; gunakan aturan keamanan di setiap titik akhir.
Kontrak mesin
Komunitas OpenAPI JSON/api/v1/community/public/openapi/v1Kontrak versi publik untuk penyematan etalase, penemuan komunitas, dan penyerahan sadar lokal.
03
API Pemasok
Hubungkan sistem pemasok yang disetujui ke paket produksi yang dirilis, status orientasi, dan alur kerja webhook ERP atau PLM.
- Apa yang tercakup dalam kontrak
- Status orientasi pemasok, paket produksi yang dirilis, unduhan artefak yang diaudit, analitik, langganan webhook, dan pos pemeriksaan sinkronisasi.
- Sebuah titik awal yang praktis
- Rencanakan koneksi antara ERP atau sistem manajemen siklus hidup produk Anda dan Pusat Pemasok. Tinjau muatan webhook, percobaan ulang, dan status sinkronisasi sebelum menangani pesanan yang ditetapkan.
- Akses
- Baca spesifikasi OpenAPI tanpa masuk. Permintaan operasional memerlukan akun pemasok dan izin yang sesuai; dokumentasi publik tidak mendaftarkan pemasok atau memberikan akses ke data pemasok lain.
Kontrak mesin
Pemasok OpenAPI JSON/api/v1/supplier/openapi/v1Kontrak publik untuk perencanaan dan pembuatan klien. Akses pemasok operasional tetap diizinkan.
04
Enterprise Identity API
Hubungkan ruang kerja perusahaan yang disetujui ke sistem masuk tunggal, penyediaan pengguna dan grup, serta catatan audit identitas.
- Apa yang tercakup dalam kontrak
- Sistem masuk tunggal OpenID Connect (OIDC), operasi siklus hidup pengguna dan grup SCIM, rotasi token SCIM, dan peristiwa audit penyediaan.
- Sebuah titik awal yang praktis
- Petakan penyedia identitas Anda ke ruang kerja yang disetujui. Rencanakan proses masuk, penyediaan dan pencabutan akses pengguna, lalu verifikasi pemetaan grup dan catatan audit di lingkungan pengujian yang disepakati.
- Akses
- Spesifikasi identitas perusahaan dilindungi. Hubungi tim integrasi untuk meninjau ruang kerja dan persyaratan akses sebelum implementasi. Identitas perusahaan bersifat opsional untuk pembelian produk biasa.
Kontrak mesin
Identitas perusahaan OpenAPI JSON/api/v1/enterprise/identity/openapi/v1Kontrak yang dilindungi untuk ruang kerja perusahaan yang disetujui; meminta akses sebelum menggunakan titik akhir ini.
Rencanakan integrasi02 — Panduan implementasi
Pilih kontrak sebelum kode
- 01
Petakan perjalanan pengguna
Putuskan siapa yang memasuki alur kerja dan di mana: pembeli di etalase tertanam, pemasok yang disetujui, pengguna perusahaan, atau asisten yang beroperasi dengan otorisasi eksplisit.
- 02
Konfirmasikan batas akses
Gunakan kontrak publik untuk evaluasi dan pembuatan klien, lalu konfirmasikan kredensial, cakupan, lingkungan, callback, dan titik akhir yang dilindungi sebelum implementasi.
- 03
Buktikan kesinambungan keadaan
Uji apakah desain, kuotasi, persetujuan, kesalahan, dan penyerahan pesanan tetap mengikuti versi terkini di seluruh integrasi, termasuk jalur percobaan ulang dan rollback.
03 — Apa yang harus dilestarikan oleh setiap integrasi
Apa yang harus dilestarikan oleh setiap integrasi
Satu negara bagian
Desain, tujuan perdagangan, penawaran harga yang didukung pemasok, persetujuan, dan status pesanan tetap terhubung. Perubahan yang sudah usang harus memicu status penawaran harga ulang atau peninjauan ulang yang terlihat.
Privasi komersial dan pemasok
MerchandAise tetap menjadi pedagang dan pemilik dukungan yang berhadapan dengan pembeli. Identitas pemasok, kontak, dan data internal tidak diekspos melalui integrasi publik.
Persetujuan sebelum produksi
Tampilan 3D bukanlah bukti fisik. penawaran harga yang dikonfirmasi menjelaskan pilihan sampel pelanggan yang tersedia, biaya, batasan, dan waktu. Menyetujui pratinjau desain digital yang tepat dan menyelesaikan pemeriksaan teknis wajib serta persetujuan sampel yang diperlukan atau dipilih sebelum produksi massal. Persyaratan pesanan yang diterima tetap mengikat.
04
Sebelum lalu lintas produksi
File OpenAPI yang dipublikasikan adalah permukaan perencanaan, bukan janji akses produksi anonim. Kami meninjau lingkungan, kredensial, penanganan kegagalan, dan kepemilikan operasional sebelum diluncurkan.
Akses dan lingkungan
Konfirmasikan versi kontrak, ruang kerja yang disetujui, cakupan autentikasi, sandbox, kredensial produksi, dan tujuan panggilan balik.
Kegagalan dan pemulihan
Tentukan percobaan ulang, idempotensi, batas waktu, kesalahan yang terlihat oleh pelanggan, kemampuan observasi, kepemilikan dukungan, dan rollback sebelum rilis.
Bukti ujung ke ujung
Verifikasi perjalanan yang dimaksudkan dalam pementasan mulai dari masuk dan mutasi negara melalui penawaran harga, persetujuan, serah terima, dan perilaku pemulihan.
FAQ
API barang dagangan manakah yang harus saya mulai?
Mulailah dengan transisi orang dan keadaan. Gunakan penyematan komunitas untuk perjalanan klub atau komunitas yang berhadapan langsung dengan pembeli, operasi pemasok untuk alur kerja sisi pasokan yang disetujui, identitas perusahaan untuk SSO dan SCIM, dan peralatan asisten hanya untuk alur yang dipimpin AI yang diberi izin secara eksplisit.
Apakah kontrak publik berarti akses produksi publik?
Tidak. Kontrak OpenAPI publik mendukung penemuan, tinjauan arsitektur, dan pembuatan klien. Kredensial produksi, operasi penulisan, alur kerja pemasok, identitas perusahaan, dan eksekusi asisten masih memerlukan ruang kerja yang disetujui dan otorisasi terbatas.
Bisakah integrasi mengekspos pemasok atau mengabaikan persetujuan?
Tidak. Identitas pemasok dan detail kontak tetap bersifat pribadi kecuali jika pengungkapan diperlukan, MerchandAise memiliki hubungan pembeli, dan tindakan yang memengaruhi pesanan harus menjaga persyaratan persetujuan sampel tahan digital, teknis, dan khusus pesanan yang dikonfigurasi.
Rencanakan integrasi Anda dengan kami.
Beri tahu kami siapa yang akan menggunakan integrasi tersebut, status mana yang perlu mereka baca atau ubah, dan di mana pengalaman tersebut akan diterapkan. Kami akan memetakan kontrak, model akses, dan jalur peluncuran teraman bersama Anda.