# Merchandise API & kontrak integrasi | MerchandAise

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

Terokai kontrak MerchandAise untuk perkakas pembantu, benam komuniti, operasi pembekal, dan identiti perusahaan, dengan sempadan akses awam dan dilindungi yang jelas.

## Kekalkan satu sumber rujukan yang sahih
Satu integrasi harus melanjutkan alur kerja MerchandAise, bukannya mencipta cawangan baharu. Permukaan laman web, benaman, pembekal, perusahaan, dan pembantu masa depan mesti membaca serta mengemas kini reka bentuk versi yang sama, niat perdagangan, sebut harga, kelulusan, dan status pesanan.
Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order.

## API dan permukaan integrasi
- **Dokumen perkakas pembantu API:** Terokai titik akhir pembantu dan perkakas semasa untuk sesi reka bentuk dan semakan integrasi. Rujukan awam ini tidak memberikan kuasa tanpa nama untuk memberi sebut harga atau membuat pesanan. Human guide: Buka dokumen perkakas pembantu (/ms/developers/api-integrations). Machine-readable contract: OpenAPI JSON perkakas pembantu (/api/docs/openapi.json). Akses: Awam. Rujukan awam untuk pembantu dan perkakas APIs. Akses pengeluaran dan operasi yang memberi kesan kepada pesanan masih memerlukan kebenaran yang berkenaan. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **Benam komuniti API:** Sambungkan pengalaman kelab, komuniti, atau kedai yang dilokalisasikan kepada penyerahan reka bentuk dan perdagangan milik MerchandAise tanpa membina semula alur kerja asas. Human guide: Semak panduan integrasi komuniti (/ms/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI JSON komuniti (/api/v1/community/public/openapi/v1). Akses: Awam. Kontrak versi awam untuk benaman kedai, penemuan komuniti, dan penyerahan sedar lokaliti. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **Pembekal API:** Sambungkan pembekal yang diluluskan kepada operasi pemulaan, katalog, sebut harga, dan pemenuhan selepas hubungan pembekal serta model akses layak. Human guide: Semak panduan integrasi pembekal (/ms/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON pembekal (/api/v1/supplier/openapi/v1). Akses: Awam. Kontrak awam untuk perancangan dan penjanaan klien. Akses pembekal operasi kekal tertakluk kepada kebenaran. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **Identiti perusahaan API:** Rancang SSO, peruntukan SCIM, dan aliran identiti sedia audit untuk program mercu tanda syarikat yang diluluskan serta pelancaran terurus. Human guide: Semak panduan integrasi perusahaan (/ms/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON identiti perusahaan (/api/v1/enterprise/identity/openapi/v1). Akses: Dilindungi. Kontrak terlindung untuk ruang kerja perusahaan yang diluluskan; minta akses sebelum menggunakan titik akhir ini. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Pilih kontrak sebelum kod
- **Step 1: Petakan perjalanan pengguna:** Tentukan siapa yang memasuki alur kerja dan di mana: pembeli dalam kedai terpaku, pembekal yang diluluskan, pengguna perusahaan, atau pembantu yang beroperasi dengan kebenaran jelas.
- **Step 2: Sahkan sempadan akses:** Gunakan kontrak awam untuk penilaian dan penjanaan klien, kemudian sahkan kelayakan, skop, persekitaran, panggilan balik, dan titik akhir terlindung sebelum pelaksanaan.
- **Step 3: Buktikan kesinambungan status:** Uji bahawa reka bentuk, sebut harga, kelulusan, ralat, dan penyerahan pesanan kekal versi semasa merentas integrasi, termasuk percubaan semula dan laluan undur.

## Perkara yang mesti dipelihara oleh setiap integrasi
- **Satu status bersiri:** Reka bentuk, niat perdagangan, sebut harga disokong pembekal, kelulusan, dan status pesanan kekal bersambung. Perubahan lapuk mesti mencetuskan sebut harga semula yang kelihatan atau status semakan.
- **Privasi komersial dan pembekal:** MerchandAise kekal sebagai peniaga yang berdepan dengan pembeli dan pemilik sokongan. Identiti pembekal, maklumat perhubungan, dan data dalaman tidak mendedahkan melalui integrasi awam.
- **Kelulusan sebelum pengeluaran:** A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding.

## Sebelum trafik pengeluaran
Fail OpenAPI yang diterbitkan ialah permukaan perancangan, bukan janji akses pengeluaran tanpa nama. Kami menyemak persekitaran, kelayakan, pengendalian kegagalan, dan pemilikan operasi sebelum pelancaran langsung.
- **Akses dan persekitaran:** Sahkan versi kontrak, ruang kerja yang diluluskan, skop pengesahan, kotak pasir, kelayakan pengeluaran, dan destinasi panggilan balik.
- **Kegagalan dan pemulihan:** Tentukan percubaan semula, idempoten, masa tamat, ralat kelihatan pelanggan, kebolehcerapan, pemilikan sokongan, dan undur sebelum pelancaran.
- **Bukti hujung ke hujung:** Sahkan perjalanan yang dimaksudkan di peringkat pementasan dari kemasukan dan mutasi status melalui sebut harga, kelulusan, penyerahan, dan tingkah laku pemulihan.

## Soalan Lazim
- **Permukaan integrasi manakah yang patut saya mulakan?:** Mulakan dengan individu dan peralihan status. Gunakan benam komuniti untuk perjalanan kelab atau komuniti yang berdepan pembeli, operasi pembekal untuk alur kerja sebelah bekalan yang diluluskan, identiti perusahaan untuk SSO dan SCIM, serta perkakas pembantu hanya untuk aliran yang dipimpin oleh AI yang diberi kuasa secara jelas.
- **Adakah kontrak awam bermaksud akses pengeluaran awam?:** Tidak. Kontrak OpenAPI awam menyokong penemuan, semakan arkitektur, dan penjanaan klien. Kelayakan pengeluaran, operasi tulis, alur kerja pembekal, identiti perusahaan, dan pelaksanaan pembantu mungkin masih memerlukan ruang kerja yang diluluskan serta kebenaran berskop.
- **Bolehkah integrasi mendedahkan pembekal atau memintas kelulusan?:** No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements.

## Bawa alur kerja kepada kami, bukan arkitektur yang siap.
Beritahu kami siapa yang akan menggunakan integrasi tersebut, status mana yang perlu mereka baca atau ubah, dan di mana pengalaman itu akan ditempatkan. Kami akan memetakan kontrak, model akses, dan laluan pelancaran paling selamat bersama anda.
- **Rancang integrasi:** /ms/contact?intent=api-integration-review
- **Terokai ejen AI dan MCP:** /ms/developers/ai-agents-mcp