# Dokumen API Barangan & Integrasi OpenAPI | MerchandAise

- slug: developers-api-integrations
- locale: ms
- localeResolved: ms
- canonical: https://www.merchandaise.com/ms/developers/api-integrations

Terokai MerchandAise dokumen API dan spesifikasi OpenAPI untuk barangan tersuai, benaman komuniti, aliran kerja pembekal dan identiti perusahaan.

## Pilih sambungan yang diperlukan oleh projek anda
Gunakan rujukan di bawah untuk menilai titik akhir, format permintaan dan keperluan kebenaran. Spesifikasi awam menyokong perancangan dan penjanaan pelanggan; akses operasi bergantung pada API, akaun dan persekitaran.
Di mana MerchandAise memproses transaksi pembeli, Hutter Products GmbH ialah penjual berkontrak dan Merchant of Record di bawah jenama MerchandAise. Identiti pembekal dan butiran hubungan kekal peribadi kecuali jika pendedahan diperlukan, dan pengeluaran masih memerlukan kelulusan kalis digital, kebolehhasilan yang disahkan, semakan teknikal mandatori dan kelulusan sampel yang terpakai pada pesanan yang diterima tepat.

## API dan permukaan integrasi
- **Dokumen API & OpenAPI:** Cari rujukan API untuk sesi alatan dan reka bentuk pembantu, kemudian pilih kontrak komuniti, pembekal atau perusahaan untuk aliran kerja anda. Panduan pelaksanaan: Baca dokumen alat pembantu (/api/docs). Kontrak mesin: Pembantu perkakas OpenAPI JSON (/api/docs/openapi.json). Akses: Awam. Rujukan awam untuk API pembantu dan perkakas. Akses pengeluaran dan operasi yang menjejaskan pesanan masih memerlukan kebenaran yang berkenaan. Halaman kanonik: /ms/developers/api-integrations. Bahagian kanonik: /ms/developers/api-integrations#api-docs.
- **API komuniti:** Sambungkan tapak web kelab atau komuniti kepada maklumat komuniti awam, penyerahan reka bentuk, undian dan serahan kelulusan pesanan. Apa yang dilindungi oleh kontrak: Konteks komuniti awam, reka bentuk siaran dan undian, penerbitan penyenaraian, pesanan belum selesai dan kelulusan atau penolakan pemilik komuniti. Titik permulaan yang praktikal: Baca konteks komuniti awam untuk tapak web kelab. Kemudian petakan tindakan yang memerlukan sesi ahli atau kebenaran pemilik sebelum menambahkan penyerahan reka bentuk atau penyerahan pembayaran. Akses: Spesifikasi adalah awam. Bacaan awam, tindakan ahli dan operasi pemilik sahaja mempunyai keperluan kebenaran yang berbeza; gunakan peraturan keselamatan pada setiap titik akhir. Panduan pelaksanaan: Terokai API Komuniti (/ms/developers/api-integrations#community-integrations). Kontrak mesin: Komuniti OpenAPI JSON (/api/v1/community/public/openapi/v1). Akses: Awam. Kontrak versi awam untuk benaman etalase, penemuan komuniti dan penyerahan makluman setempat. Halaman kanonik: /ms/developers/api-integrations. Bahagian kanonik: /ms/developers/api-integrations#community-integrations.
- **API Pembekal:** Sambungkan sistem pembekal yang diluluskan kepada pakej pengeluaran yang dikeluarkan, status onboarding dan aliran kerja webhook ERP atau PLM. Apa yang dilindungi oleh kontrak: Keadaan onboarding pembekal, pakej pengeluaran yang dikeluarkan, muat turun artifak yang diaudit, analitis, langganan webhook dan pusat pemeriksaan penyegerakan. Titik permulaan yang praktikal: Rancang sambungan antara ERP atau sistem pengurusan kitaran hayat produk anda dan Pusat Pembekal. Semak muatan webhook, cuba semula dan status penyegerakan sebelum mengendalikan pesanan yang ditetapkan. Akses: Baca spesifikasi OpenAPI tanpa melog masuk. Permintaan operasi memerlukan akaun pembekal yang sesuai dan kebenaran; dokumentasi awam tidak mendaftarkan pembekal atau memberikan akses kepada data pembekal lain. Panduan pelaksanaan: Teroka API Pembekal (/ms/developers/api-integrations#supplier-integrations). Kontrak mesin: Pembekal OpenAPI JSON (/api/v1/supplier/openapi/v1). Akses: Awam. Kontrak awam untuk perancangan dan penjanaan pelanggan. Akses pembekal operasi kekal dibenarkan. Halaman kanonik: /ms/developers/api-integrations. Bahagian kanonik: /ms/developers/api-integrations#supplier-integrations.
- **Enterprise Identity API:** Sambungkan ruang kerja syarikat yang diluluskan kepada log masuk tunggal, peruntukan pengguna dan kumpulan serta rekod audit identiti. Apa yang dilindungi oleh kontrak: Log masuk tunggal OpenID Connect (OIDC), operasi kitaran hayat pengguna dan kumpulan SCIM, putaran token SCIM dan acara audit peruntukan. Titik permulaan yang praktikal: Petakan pembekal identiti anda ke ruang kerja yang diluluskan. Rancang log masuk, peruntukan pengguna dan nyah peruntukan, kemudian sahkan pemetaan kumpulan dan rekod audit dalam persekitaran ujian yang dipersetujui. Akses: Spesifikasi identiti perusahaan dilindungi. Hubungi pasukan penyepaduan untuk menyemak ruang kerja dan keperluan akses sebelum pelaksanaan. Identiti perusahaan adalah pilihan untuk pembelian produk biasa. Panduan pelaksanaan: Terokai identiti perusahaan (/ms/developers/api-integrations#enterprise-integrations). Kontrak mesin: Identiti perusahaan OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Akses: Dilindungi. Kontrak yang dilindungi untuk ruang kerja perusahaan yang diluluskan; minta akses sebelum menggunakan titik akhir ini. Halaman kanonik: /ms/developers/api-integrations. Bahagian kanonik: /ms/developers/api-integrations#enterprise-integrations.

## Pilih kontrak sebelum kod
- **Langkah 1: Petakan perjalanan pengguna:** Tentukan siapa yang memasuki aliran kerja dan tempat: pembeli dalam etalase terbenam, pembekal yang diluluskan, pengguna perusahaan atau pembantu yang beroperasi dengan kebenaran yang jelas.
- **Langkah 2: Sahkan sempadan akses:** Gunakan kontrak awam untuk penilaian dan penjanaan pelanggan, kemudian sahkan kelayakan, skop, persekitaran, panggilan balik dan titik akhir yang dilindungi sebelum pelaksanaan.
- **Langkah 3: Buktikan kesinambungan negeri:** Uji bahawa reka bentuk, sebut harga, kelulusan, ralat dan penyerahan pesanan kekal versi semasa merentas penyepaduan, termasuk percubaan semula dan laluan putar balik.

## Apa yang mesti dipelihara oleh setiap integrasi
- **Satu keadaan versi:** Reka bentuk, niat perdagangan, sebut harga yang disokong pembekal, kelulusan dan status pesanan kekal berhubung. Perubahan lapuk mesti mencetuskan keadaan sebut harga semula atau semakan yang kelihatan.
- **Privasi komersial dan pembekal:** MerchandAise kekal sebagai pedagang yang berhadapan dengan pembeli dan pemilik sokongan. Identiti pembekal, kenalan dan data dalaman tidak didedahkan melalui penyepaduan awam.
- **Kelulusan sebelum pengeluaran:** Pandangan 3D bukan bukti fizikal. Sebut harga yang disahkan menerangkan sebarang pilihan sampel pelanggan yang tersedia, kos, had dan masa. Luluskan pruf digital yang tepat dan lengkapkan semakan teknikal mandatori dan sebarang kelulusan sampel yang diperlukan atau terpilih sebelum pengeluaran besar-besaran. Keperluan tempahan diterima sedia ada kekal mengikat.

## Sebelum lalu lintas pengeluaran
Fail OpenAPI yang diterbitkan ialah permukaan perancangan, bukan janji akses pengeluaran tanpa nama. Kami menyemak persekitaran, bukti kelayakan, pengendalian kegagalan dan pemilikan operasi sebelum siaran langsung.
- **Akses dan persekitaran:** Sahkan versi kontrak, ruang kerja yang diluluskan, skop pengesahan, kotak pasir, bukti kelayakan pengeluaran dan destinasi panggil balik.
- **Kegagalan dan pemulihan:** Tentukan percubaan semula, idempotensi, tamat masa, ralat yang boleh dilihat oleh pelanggan, kebolehmerhatian, pemilikan sokongan dan pemulangan semula sebelum dikeluarkan.
- **Bukti hujung ke hujung:** Sahkan perjalanan yang dimaksudkan dalam pementasan daripada mutasi kemasukan dan keadaan melalui sebut harga, kelulusan, penyerahan dan tingkah laku pemulihan.

## FAQ
- **API barangan yang manakah harus saya mulakan?:** Mulakan dengan peralihan orang dan keadaan. Gunakan benaman komuniti untuk perjalanan kelab atau komuniti yang berhadapan dengan pembeli, operasi pembekal untuk aliran kerja bahagian bekalan yang diluluskan, identiti perusahaan untuk SSO dan SCIM dan alat pembantu hanya untuk aliran yang diterajui AI yang dibenarkan secara jelas.
- **Adakah kontrak awam bermakna akses pengeluaran awam?:** Tidak. Kontrak OpenAPI awam menyokong penemuan, semakan seni bina dan penjanaan pelanggan. Bukti kelayakan pengeluaran, operasi tulis, aliran kerja pembekal, identiti perusahaan dan pembantu pelaksanaan masih boleh memerlukan ruang kerja yang diluluskan dan kebenaran berskop.
- **Bolehkah integrasi mendedahkan pembekal atau memintas kelulusan?:** Tidak. Identiti pembekal dan butiran hubungan kekal peribadi kecuali jika pendedahan diperlukan, MerchandAise memiliki perhubungan pembeli dan tindakan yang mempengaruhi pesanan mesti mengekalkan keperluan kelulusan sampel kalis digital, teknikal dan khusus pesanan yang dikonfigurasikan.

## Rancang integrasi anda dengan kami.
Beritahu kami siapa yang akan menggunakan penyepaduan, yang menyatakan mereka perlu membaca atau menukar, dan di mana pengalaman itu akan hidup. Kami akan memetakan kontrak, model akses dan laluan pelancaran paling selamat dengan anda.
- **Rancang integrasi:** /ms/contact?intent=api-integration-review
- **Terokai ejen AI dan MCP:** /ms/developers/ai-agents-mcp
