Lewati ke konten utama

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.

Akses: Publik

Panduan implementasi

Baca dokumen perkakas asisten
/api/docs/openapi.json

Referensi 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.
Akses: Publik/api/v1/community/public/openapi/v1

Kontrak 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.
Akses: Publik/api/v1/supplier/openapi/v1

Kontrak 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.
Akses: Dilindungi

Kontrak mesin

Identitas perusahaan OpenAPI JSON
/api/v1/enterprise/identity/openapi/v1

Kontrak yang dilindungi untuk ruang kerja perusahaan yang disetujui; meminta akses sebelum menggunakan titik akhir ini.

Rencanakan integrasi

02 — Panduan implementasi

Pilih kontrak sebelum kode

  1. 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.

  2. 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.

  3. 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.

01

Akses dan lingkungan

Konfirmasikan versi kontrak, ruang kerja yang disetujui, cakupan autentikasi, sandbox, kredensial produksi, dan tujuan panggilan balik.

02

Kegagalan dan pemulihan

Tentukan percobaan ulang, idempotensi, batas waktu, kesalahan yang terlihat oleh pelanggan, kemampuan observasi, kepemilikan dukungan, dan rollback sebelum rilis.

03

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.