{"pageKey":"Developers","slug":"developers-api-integrations","locale":"id","localeResolved":"id","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/id/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Kontrak integrasi & API merchandise | MerchandAise","description":"Jelajahi kontrak MerchandAise untuk alat asisten, sematan komunitas, operasional pemasok, dan identitas perusahaan, dengan batasan akses publik dan terproteksi yang jelas.","sections":[{"heading":"Pertahankan satu sumber kebenaran data","paragraphs":["Integrasi harus memperluas alur kerja MerchandAise, bukan mencabangkannya. Situs web, sematan, pemasok, perusahaan, dan antarmuka asisten di masa mendatang harus membaca dan memperbarui desain, intensi perdagangan, penawaran, persetujuan, dan status pesanan versi yang sama.","Dalam hal MerchandAise memproses transaksi pembeli, Hutter Products GmbH bertindak sebagai penjual kontrak dan Merchant of Record di bawah merek MerchandAise. Identitas dan detail kontak pemasok tetap bersifat pribadi kecuali jika pengungkapan diwajibkan, dan produksi tetap memerlukan persetujuan bukti digital (digital proof) serta sampel fisik asli (genuine sample)."]},{"heading":"Antarmuka integrasi dan API","items":[{"title":"Dokumentasi API alat asisten","description":"Jelajahi endpoint asisten dan alat bantu saat ini untuk sesi desain dan tinjauan integrasi. Referensi publik ini tidak memberikan wewenang anonim untuk membuat penawaran atau melakukan pemesanan. Human guide: Buka dokumentasi alat asisten (/id/developers/api-integrations). Machine-readable contract: JSON OpenAPI alat asisten (/api/docs/openapi.json). Access: public. Referensi publik untuk API asisten dan alat bantu. Akses produksi dan operasi yang memengaruhi pesanan tetap memerlukan otorisasi yang berlaku. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"API sematan komunitas","description":"Hubungkan pengalaman klub, komunitas, atau etalase lokal ke serah terima desain dan perdagangan milik MerchandAise tanpa membangun kembali alur kerja dasarnya. Human guide: Tinjau panduan integrasi komunitas (/id/developers/api-integrations#community-integrations). Machine-readable contract: JSON OpenAPI komunitas (/api/v1/community/public/openapi/v1). Access: public. Kontrak terversi publik untuk sematan etalase, penemuan komunitas, dan serah terima yang menyesuaikan lokalitas. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"API Pemasok","description":"Hubungkan pemasok yang disetujui ke operasional orientasi (onboarding), katalog, penawaran, dan pemenuhan pesanan setelah hubungan pemasok dan model akses memenuhi syarat. Human guide: Tinjau panduan integrasi pemasok (/id/developers/api-integrations#supplier-integrations). Machine-readable contract: JSON OpenAPI pemasok (/api/v1/supplier/openapi/v1). Access: public. Kontrak publik untuk perencanaan dan pembuatan klien. Akses operasional pemasok tetap memerlukan izin khusus. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"API identitas perusahaan","description":"Rencanakan SSO, penyediaan SCIM, dan alur identitas yang siap diaudit untuk program merchandise perusahaan yang disetujui serta peluncuran yang terkelola. Human guide: Tinjau panduan integrasi perusahaan (/id/developers/api-integrations#enterprise-integrations). Machine-readable contract: JSON OpenAPI identitas perusahaan (/api/v1/enterprise/identity/openapi/v1). Access: protected. Kontrak terproteksi untuk ruang kerja perusahaan yang disetujui; ajukan permintaan akses sebelum menggunakan endpoint ini. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Pilih kontrak sebelum menulis kode","items":[{"title":"Step 1: Petakan perjalanan pengguna","description":"Tentukan siapa yang masuk ke alur kerja dan di mana: pembeli di etalase tersemat, pemasok yang disetujui, pengguna perusahaan, atau asisten yang beroperasi dengan otorisasi eksplisit."},{"title":"Step 2: Konfirmasikan batasan akses","description":"Gunakan kontrak publik untuk evaluasi dan pembuatan klien, lalu konfirmasikan kredensial, cakupan (scope), lingkungan (environment), callback, dan endpoint terproteksi sebelum implementasi."},{"title":"Step 3: Buktikan kontinuitas status","description":"Uji apakah desain, penawaran, persetujuan, kesalahan, dan serah terima pesanan tetap menggunakan versi terbaru di seluruh integrasi, termasuk jalur percobaan ulang (retry) dan pembatalan (rollback)."}]},{"heading":"Hal yang wajib dipertahankan oleh setiap integrasi","items":[{"title":"Satu status terversi","description":"Desain, intensi perdagangan, penawaran yang didukung pemasok, persetujuan, dan status pesanan tetap terhubung. Perubahan yang usang harus memicu penawaran ulang yang terlihat atau status peninjauan."},{"title":"Privasi komersial dan pemasok","description":"MerchandAise tetap menjadi merchant yang berhadapan dengan pembeli dan pemilik dukungan. Identitas, kontak, dan data internal pemasok tidak akan diekspos melalui integrasi publik."},{"title":"Persetujuan sebelum produksi","description":"Tampilan 3D bawaan produk dan bukti digital mendukung keputusan tersebut, tetapi tidak menggantikan sampel produksi asli yang wajib ada sebelum produksi massal."}]},{"heading":"Sebelum lalu lintas produksi aktif","paragraphs":["File OpenAPI yang dipublikasikan adalah sarana perencanaan, bukan jaminan akses produksi anonim. Kami meninjau lingkungan, kredensial, penanganan kegagalan, dan kepemilikan operasional sebelum peluncuran langsung (go-live)."],"items":[{"title":"Akses dan lingkungan","description":"Konfirmasikan versi kontrak, ruang kerja yang disetujui, cakupan autentikasi, sandbox, kredensial produksi, dan tujuan callback."},{"title":"Kegagalan dan pemulihan","description":"Tentukan percobaan ulang (retry), idempotensi, batas waktu (timeout), kesalahan yang terlihat oleh pelanggan, observabilitas, kepemilikan dukungan, dan pembatalan (rollback) sebelum rilis."},{"title":"Bukti ujung-ke-ujung","description":"Verifikasi perjalanan yang dimaksud di lingkungan staging mulai dari entri dan mutasi status hingga penawaran, persetujuan, serah terima, dan perilaku pemulihan."}]},{"heading":"FAQ","items":[{"title":"Antarmuka integrasi mana yang sebaiknya saya gunakan terlebih dahulu?","description":"Mulailah dengan transisi status dan pengguna. Gunakan sematan komunitas untuk perjalanan klub atau komunitas yang berhadapan dengan pembeli, operasional pemasok untuk alur kerja sisi penawaran yang disetujui, identitas perusahaan untuk SSO dan SCIM, dan alat asisten hanya untuk alur kerja berbasis AI yang diotorisasi secara eksplisit."},{"title":"Apakah kontrak publik berarti akses produksi publik?","description":"Tidak. Kontrak OpenAPI publik mendukung penemuan, tinjauan arsitektur, dan pembuatan klien. Kredensial produksi, operasi tulis, alur kerja pemasok, identitas perusahaan, dan eksekusi asisten tetap memerlukan ruang kerja yang disetujui dan otorisasi dengan cakupan tertentu."},{"title":"Apakah integrasi dapat mengekspos pemasok atau melewati persetujuan?","description":"Tidak. Identitas dan detail kontak pemasok tetap bersifat pribadi kecuali jika pengungkapan diwajibkan, MerchandAise memiliki hubungan dengan pembeli, dan tindakan yang memengaruhi pesanan harus mempertahankan alur persetujuan yang dikonfigurasi serta gerbang sampel fisik asli."}]},{"heading":"Bawa alur kerjanya kepada kami, bukan arsitektur yang sudah jadi.","paragraphs":["Beri tahu kami siapa yang akan menggunakan integrasi ini, status mana yang perlu mereka baca atau ubah, dan di mana pengalaman tersebut akan berjalan. Kami akan memetakan kontrak, model akses, dan jalur peluncuran teraman bersama Anda."],"items":[{"title":"Rencanakan integrasi","description":"/id/contact?intent=api-integration-review"},{"title":"Jelajahi agen AI dan MCP","description":"/id/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}