MerchandAise geliştirici platformu

Tek bir ürün iş akışı. Bağlanmanın dört yolu.

Bir web sitesini, topluluğu, tedarikçi operasyonunu veya kurumsal çalışma alanını aynı sürümlendirilmiş tasarıma, teklife, onaya ve sipariş durumuna bağlayın. Yayınlanan sözleşmeyle başlayın, ardından erişim ve canlıya geçiş planlamasını bizimle birlikte yapın.

Tek bir doğru bilgi kaynağı sağlayın

Bir entegrasyon MerchandAise iş akışını çatallandırmamalı, aksine genişletmelidir. Web sitesi, yerleştirme, tedarikçi, kurumsal ve gelecekteki asistan arayüzleri aynı sürümlendirilmiş tasarımı, ticari amacı, teklifi, onayı ve sipariş durumunu okumalı ve güncellemelidir.

MerchandAise'ın alıcı işlemini gerçekleştirdiği durumlarda, MerchandAise markası altında sözleşmeli satıcı ve Kayıtlı Satıcı (Merchant of Record) Hutter Products GmbH'dir. Tedarikçi kimliği ve iletişim bilgileri, açıklanması zorunlu olan durumlar haricinde gizli kalır ve üretim için dijital prova ile fiziksel numune onayı alınması hâlâ zorunludur.

01 — Sözleşmeler

API ve entegrasyon arayüzleri

Asistan araçları API belgeleri

Tasarım oturumları ve entegrasyon incelemesi için mevcut asistan ve araç uç noktalarını keşfedin. Bu genel referans, anonim olarak teklif alma veya sipariş verme yetkisi vermez.

Erişim: public

Uygulama kılavuzu

Asistan araçları belgelerini aç

Makine sözleşmesi

Asistan araçları OpenAPI JSON

/api/docs/openapi.json

Asistan ve araç API'leri için genel referans. Canlı ortam erişimi ve siparişi etkileyen işlemler için geçerli yetkilendirme hâlâ zorunludur.

Topluluk yerleştirme API'si

Yerelleştirilmiş kulüp, topluluk veya mağaza deneyimlerini, temel iş akışını yeniden oluşturmadan MerchandAise yönetimindeki tasarım ve ticaret süreçlerine bağlayın.

Erişim: public

Makine sözleşmesi

Topluluk OpenAPI JSON

/api/v1/community/public/openapi/v1

Mağaza yerleştirmeleri, topluluk keşfi ve yerel ayarlara duyarlı süreç aktarımları için genel sürümlendirilmiş sözleşme.

Tedarikçi API'si

Tedarikçi ilişkisi ve erişim modeli doğrulandıktan sonra, onaylı tedarikçileri sisteme katılım, katalog, teklif ve sipariş karşılama operasyonlarına bağlayın.

Erişim: public

Makine sözleşmesi

Tedarikçi OpenAPI JSON

/api/v1/supplier/openapi/v1

Planlama ve istemci oluşturma için genel sözleşme. Operasyonel tedarikçi erişimi izne tabi olmaya devam eder.

Kurumsal kimlik API'si

Onaylı şirket ürün programları ve denetlenen canlıya geçiş süreçleri için SSO, SCIM yapılandırması ve denetime hazır kimlik akışları planlayın.

Erişim: protected

Makine sözleşmesi

Kurumsal kimlik OpenAPI JSON

/api/v1/enterprise/identity/openapi/v1

Onaylı kurumsal çalışma alanları için korumalı sözleşme; bu uç noktayı kullanmadan önce erişim talep edin.

02 — Uygulama kılavuzu

Koddan önce sözleşmeyi seçin

01
Kullanıcı yolculuğunu haritalandırın
İş akışına kimin ve nereden dahil olacağına karar verin: yerleşik bir mağazadaki alıcı, onaylı bir tedarikçi, kurumsal bir kullanıcı veya açık yetkilendirmeyle çalışan bir asistan.
02
Erişim sınırını onaylayın
Değerlendirme ve istemci oluşturma için genel sözleşmeleri kullanın; ardından uygulamaya geçmeden önce kimlik bilgilerini, kapsamları, ortamları, geri çağırmaları (callbacks) ve korumalı uç noktaları onaylayın.
03
Durum sürekliliğini kanıtlayın
Tasarımların, tekliflerin, onayların, hataların ve sipariş aktarımlarının, yeniden denemeler ve geri alma yolları da dahil olmak üzere entegrasyon boyunca güncel sürümde kaldığını test edin.

03 — Her entegrasyonun koruması gerekenler

Her entegrasyonun koruması gerekenler

Tek bir sürümlendirilmiş durum

Tasarım, ticari amaç, tedarikçi destekli teklif, onay ve sipariş durumu bağlantılı kalır. Güncelliğini yitirmiş değişiklikler, görünür bir yeniden teklif alma veya inceleme durumunu tetiklemelidir.

Ticari ve tedarikçi gizliliği

MerchandAise, alıcıya yönelik satıcı ve destek sahibi olmaya devam eder. Tedarikçi kimlikleri, iletişim bilgileri ve dahili veriler genel entegrasyonlar aracılığıyla açığa çıkarılmaz.

Üretim öncesi onay

Ürüne özgü bir 3D görünüm ve dijital prova kararı destekler, ancak seri üretimden önce zorunlu olan fiziksel üretim numunesinin yerini almaz.

Canlı ortam trafiğinden önce

Yayınlanmış bir OpenAPI dosyası bir planlama arayüzüdür, anonim canlı ortam erişimi vaadi değildir. Canlıya geçişten önce ortamları, kimlik bilgilerini, hata yönetimini ve operasyonel sahipliği gözden geçiririz.

Erişim ve ortamlar

Sözleşme sürümünü, onaylı çalışma alanını, kimlik doğrulama kapsamlarını, sandbox'ı, canlı ortam kimlik bilgilerini ve geri çağırma hedeflerini onaylayın.

Hata ve kurtarma

Sürümden önce yeniden denemeleri, eşkuvvetliliği (idempotency), zaman aşımlarını, müşteri tarafından görülebilen hataları, izlenebilirliği, destek sahipliğini ve geri almayı tanımlayın.

Uçtan uca kanıt

Giriş ve durum değişikliğinden teklif, onay, aktarım ve kurtarma davranışına kadar staging ortamında hedeflenen yolculuğu doğrulayın.

SSS

Hangi entegrasyon arayüzü ile başlamalıyım?

Kişi ve durum geçişiyle başlayın. Alıcıya yönelik kulüp veya topluluk yolculukları için topluluk yerleştirmelerini, onaylı tedarik tarafı iş akışları için tedarikçi operasyonlarını, SSO ve SCIM için kurumsal kimliği ve yalnızca açıkça yetkilendirilmiş AI yönetimli akışlar için asistan araçlarını kullanın.

Genel bir sözleşme, genel canlı ortam erişimi anlamına mı gelir?

Hayır. Genel bir OpenAPI sözleşmesi keşfi, mimari incelemeyi ve istemci oluşturmayı destekler. Canlı ortam kimlik bilgileri, yazma işlemleri, tedarikçi iş akışları, kurumsal kimlik ve asistan yürütme işlemleri için hâlâ onaylı bir çalışma alanı ve kapsamlı yetkilendirme gerekebilir.

Bir entegrasyon tedarikçileri ifşa edebilir mi veya onayları devre dışı bırakabilir mi?

Hayır. Tedarikçi kimliği ve iletişim bilgileri, açıklanması zorunlu olan durumlar haricinde gizli kalır; alıcı ilişkisinin sahibi MerchandAise'dır ve siparişi etkileyen işlemler, yapılandırılmış onay ve fiziksel numune aşamalarını korumak zorundadır.

Bize tamamlanmış bir mimari değil, iş akışını getirin.

Entegrasyonu kimin kullanacağını, hangi durumu okuması veya değiştirmesi gerektiğini ve deneyimin nerede barındırılacağını bize bildirin. Sözleşmeyi, erişim modelini ve en güvenli canlıya geçiş yolunu sizinle birlikte planlayalım.

Entegrasyon planlayın AI ajanlarını ve MCP'yi keşfedin

Tek bir doğru bilgi kaynağı sağlayın

Koddan önce sözleşmeyi seçin

Kullanıcı yolculuğunu haritalandırın

İş akışına kimin ve nereden dahil olacağına karar verin: yerleşik bir mağazadaki alıcı, onaylı bir tedarikçi, kurumsal bir kullanıcı veya açık yetkilendirmeyle çalışan bir asistan.

Erişim sınırını onaylayın

Değerlendirme ve istemci oluşturma için genel sözleşmeleri kullanın; ardından uygulamaya geçmeden önce kimlik bilgilerini, kapsamları, ortamları, geri çağırmaları (callbacks) ve korumalı uç noktaları onaylayın.

Durum sürekliliğini kanıtlayın

Tasarımların, tekliflerin, onayların, hataların ve sipariş aktarımlarının, yeniden denemeler ve geri alma yolları da dahil olmak üzere entegrasyon boyunca güncel sürümde kaldığını test edin.

Her entegrasyonun koruması gerekenler

Tek bir sürümlendirilmiş durum

Ticari ve tedarikçi gizliliği

Üretim öncesi onay

Ürüne özgü bir 3D görünüm ve dijital prova kararı destekler, ancak seri üretimden önce zorunlu olan fiziksel üretim numunesinin yerini almaz.

SSS

Hangi entegrasyon arayüzü ile başlamalıyım?

Genel bir sözleşme, genel canlı ortam erişimi anlamına mı gelir?

Bir entegrasyon tedarikçileri ifşa edebilir mi veya onayları devre dışı bırakabilir mi?

Bize tamamlanmış bir mimari değil, iş akışını getirin.