# Pusat Pengembang: API Barang Dagangan, OpenAPI & MCP | MerchandAise

- slug: developers
- locale: id
- localeResolved: id
- canonical: https://www.merchandaise.com/id/developers

Bangun integrasi barang dagangan khusus dengan API MerchandAise. Jelajahi dokumen OpenAPI, penyematan komunitas, alur kerja pemasok, SSO perusahaan, dan alat MCP.

## MerchandAise pusat pengembang
Hubungkan situs web, sistem bisnis, atau asisten AI Anda ke MerchandAise. Jelajahi API untuk desain produk, etalase komunitas, operasi pemasok, dan identitas perusahaan, dengan spesifikasi OpenAPI dan dokumentasi MCP untuk memandu integrasi Anda.

## Dibangun untuk sistem di sekitar program merchandise Anda
- **Operator komunitas:** Luncurkan etalase tertanam, serah terima konfigurator, dan aliran komunitas di dalam situs klub, liga, dan perusahaan dengan kontrak publik berversi.
- **Tim perusahaan dan mitra platform:** Hubungkan portal pengadaan, sistem identitas, dan operasi internal ke alur kerja barang dagangan tanpa membangun kembali persetujuan dan logika pemasok.
- **Agen AI dan pembuat otomatisasi:** Berikan asisten akses alat terstruktur untuk penemuan, penawaran harga, dan operasi yang disetujui melalui titik akhir yang kompatibel dengan MCP.

## Temukan integrasi Anda
- **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: Jelajahi dokumen API (/id/developers/api-integrations). Kontrak mesin: Perkakas asisten OpenAPI JSON (/api/docs/openapi.json). Akses: Publik. Referensi publik untuk API asisten dan perkakas. Akses produksi dan operasi yang memengaruhi pesanan masih memerlukan otorisasi yang berlaku. Bagian kanonik: /id/developers#api-docs.
- **API Komunitas:** Hubungkan situs web klub atau komunitas ke informasi komunitas publik, pengiriman desain, pemungutan suara, dan penyerahan persetujuan pesanan. Panduan implementasi: Jelajahi API Komunitas (/id/developers/api-integrations#community-integrations). Kontrak mesin: Komunitas OpenAPI JSON (/api/v1/community/public/openapi/v1). Akses: Publik. Kontrak versi publik untuk penyematan etalase, penemuan komunitas, dan penyerahan sadar lokal. Bagian kanonik: /id/developers#community-integrations.
- **API Pemasok:** Hubungkan sistem pemasok yang disetujui ke paket produksi yang dirilis, status orientasi, dan alur kerja webhook ERP atau PLM. Panduan implementasi: Jelajahi API Pemasok (/id/developers/api-integrations#supplier-integrations). Kontrak mesin: Pemasok OpenAPI JSON (/api/v1/supplier/openapi/v1). Akses: Publik. Kontrak publik untuk perencanaan dan pembuatan klien. Akses pemasok operasional tetap diizinkan. Bagian kanonik: /id/developers#supplier-integrations.
- **Enterprise Identity API:** Hubungkan ruang kerja perusahaan yang disetujui ke sistem masuk tunggal, penyediaan pengguna dan grup, serta catatan audit identitas. Panduan implementasi: Jelajahi identitas perusahaan (/id/developers/api-integrations#enterprise-integrations). Kontrak mesin: Identitas perusahaan OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Akses: Dilindungi. Kontrak yang dilindungi untuk ruang kerja perusahaan yang disetujui; meminta akses sebelum menggunakan titik akhir ini. Bagian kanonik: /id/developers#enterprise-integrations.
- **Agen AI & MCP:** Hubungkan asisten AI melalui Model Context Protocol. Temukan alat yang didukung dan pertahankan pilihan desain pengguna, izin, dan konfirmasi yang diperlukan. Panduan implementasi: Jelajahi agen AI & MCP (/id/developers/ai-agents-mcp). Kontrak mesin: JSON kartu server MCP publik (/.well-known/mcp/server-card). Akses: Publik. Dokumen penemuan publik untuk klien mesin. Daftar alat eksternal di /api/v1/mcp/tools memperlihatkan metadata alat saat ini; setiap panggilan alat masih mengikuti batasan keamanan, ruang kerja, dan konfirmasi yang dinyatakan. Bagian kanonik: /id/developers#mcp-tools.

## Dari permintaan pertama hingga produksi
- **Langkah 1: Pilih kontrak yang sesuai dengan alur kerja Anda:** Mulailah dengan permukaan yang cocok dengan model pengguna dan autentikasi Anda: penyematan komunitas, identitas perusahaan, operasi pemasok, atau alat MCP untuk asisten.
- **Langkah 2: Validasi batasan autentikasi, pembuatan versi, dan lingkungan:** Konfirmasikan header, cakupan, ekspektasi panggilan balik, dan versi kontrak yang diperlukan dalam penahapan sebelum Anda merutekan lalu lintas produksi.
- **Langkah 3: Uji alur kerja menyeluruh sebelum peluncuran:** Verifikasi permintaan, webhook, penyediaan, observabilitas, dan jalur rollback sehingga integrasi dapat diandalkan sejak penggunaan langsung pertama.

## Apa yang dimaksud dengan siap produksi
Integrasi produksi memerlukan lebih dari sekedar titik akhir publik. Gunakan gerbang ini untuk memutuskan apakah alur kerja Anda siap untuk lalu lintas pelanggan, pemasok, perusahaan, atau agen AI.
- **Sandbox dan tinjauan akses:** Konfirmasikan kontrak mana yang bersifat publik, platform perusahaan mana yang memerlukan persetujuan, dan kredensial atau peran ruang kerja mana yang diperlukan sebelum peluncuran.
- **Bukti implementasi berversi:** Selalu dokumentasikan klien yang dihasilkan, URL panggilan balik, cakupan autentikasi, versi kontrak, dan kepemilikan rollback sebelum lalu lintas produksi diaktifkan.
- **Observabilitas operasional:** Rencanakan log, percobaan ulang, kepemilikan dukungan, status kegagalan, dan pemeriksaan kesehatan untuk setiap alur kerja yang dapat memengaruhi pesanan, pemasok, atau pengguna perusahaan.

## Sebelum Anda mulai membangun
- **API MerchandAise mana yang harus saya gunakan?:** Gunakan API Komunitas untuk alur kerja klub dan situs web komunitas, API Pemasok untuk operasi pemasok yang disetujui, dan API Identitas Perusahaan untuk proses masuk dan penyediaan perusahaan. Referensi API mencakup peralatan asisten; panduan MCP menjelaskan cara asisten AI menemukan dan menggunakan alat yang didukung.
- **Bisakah saya membaca spesifikasi API tanpa akun?:** Peralatan asisten, spesifikasi OpenAPI Komunitas dan Pemasok bersifat publik. Spesifikasi Identitas Perusahaan dilindungi. Membaca spesifikasi publik tidak memberikan izin untuk melaksanakan permintaan yang dilindungi atau melakukan pemesanan.
- **Apakah saya memerlukan integrasi pengembang untuk memesan produk?:** Tidak. Individu, klub, dan perusahaan dapat menggunakan situs web MerchandAise untuk menjelajahi produk yang didukung dan meminta penawaran harga. API adalah cara opsional untuk menghubungkan sistem atau pengalaman Anda sendiri.
- **Apa yang harus saya sertakan dalam permintaan integrasi?:** Jelaskan siapa yang akan menggunakannya, sistem yang terlibat, informasi yang perlu Anda baca atau perbarui, dan jadwal waktu yang Anda inginkan. Sertakan persyaratan masuk, lingkungan, dan panggilan balik jika diketahui. Tim meninjau kontrak dan model akses yang sesuai dengan Anda.

## Merencanakan integrasi khusus?
Bagikan sistem yang terlibat, alur kerja yang ingin Anda dukung, dan waktu peluncuran Anda. Kami akan membantu Anda memilih kontrak, model akses, dan urutan peluncuran yang tepat.
- **Diskusikan integrasi:** /id/contact/integrations
- **Jelajahi perusahaan:** /id/enterprise
