MerchandAise geliştirici platformu
İş akışınızı MerchandAise’e bağlayın.
Kişiselleştirilmiş ürün iş akışları için API belgelerini ve OpenAPI şartnamelerini bulun. Web sitelerini, toplulukları, tedarikçi operasyonlarını veya şirket hesaplarını ortak tasarım, teklif ve sipariş bilgilerine bağlayın.
Projenizin ihtiyaç duyduğu bağlantıyı seçin
Uç noktaları, istek biçimlerini ve yetkilendirme gereksinimlerini değerlendirmek için aşağıdaki referansları kullanın. Açık şartnameler planlamayı ve istemci oluşturmayı destekler; operasyonel erişim API’ye, hesaba ve ortama bağlıdır.
MerchandAise’in alıcı işlemini yürüttüğü durumlarda Hutter Products GmbH, MerchandAise markası altında sözleşmedeki satıcı ve kayıtlı satıcıdır. Açıklamanın zorunlu olduğu durumlar dışında tedarikçi kimliği ve iletişim bilgileri gizli kalır; üretim yine dijital prova onayı, üretilebilirlik doğrulaması, zorunlu teknik kontroller ve kabul edilmiş siparişin tam sürümüne ilişkin numune onaylarını gerektirir.
01 — Sözleşmeler
API ve entegrasyon yüzeyleri
01
API belgeleri ve OpenAPI
Asistan araçları ve tasarım oturumları için API referansını bulun; ardından iş akışınıza uygun topluluk, tedarikçi veya kurumsal sözleşmeyi seçin.
Uygulama kılavuzu
Asistan araçları belgelerini okuyunMakine sözleşmesi
Asistan araçları OpenAPI JSON/api/docs/openapi.jsonAsistan ve araç API’leri için açık referans. Üretim ortamına erişim ve siparişi etkileyen işlemler yine ilgili yetkilendirmeyi gerektirir.
02
Topluluk API’si
Kulüp veya topluluk web sitesini açık topluluk bilgilerine, tasarım gönderilerine, oylamaya ve sipariş onayı geçişlerine bağlayın.
- Sözleşmenin kapsamı
- Açık topluluk bağlamı, tasarım gönderileri ve oylar, ilan yayımlama, bekleyen siparişler ve topluluk sahibinin onayı veya reddi.
- Pratik bir başlangıç noktası
- Kulüp web sitesi için açık topluluk bağlamını okuyun. Tasarım gönderileri veya ödeme geçişlerini eklemeden önce hangi eylemlerin üye oturumu veya sahip yetkisi gerektirdiğini belirleyin.
- Erişim
- Şartname herkese açıktır. Açık okuma, üye eylemleri ve yalnızca sahibin yapabileceği işlemler farklı yetkiler gerektirir; her uç noktanın güvenlik kurallarını izleyin.
Makine sözleşmesi
Topluluk OpenAPI JSON/api/v1/community/public/openapi/v1Gömülü mağazalar, topluluk keşfi ve dile duyarlı geçişler için sürümlenmiş açık sözleşme.
03
Tedarikçi API’si
Onaylı tedarikçi sistemlerini yayımlanmış üretim paketlerine, katılım durumuna ve ERP veya PLM webhook iş akışlarına bağlayın.
- Sözleşmenin kapsamı
- Tedarikçi kabul durumu, yayımlanmış üretim paketleri, denetlenen dosya indirmeleri, analizler, webhook abonelikleri ve senkronizasyon kontrol noktaları.
- Pratik bir başlangıç noktası
- ERP veya ürün yaşam döngüsü yönetim sisteminiz ile Tedarikçi Merkezi arasında bağlantı planlayın. Atanmış bir siparişi işlemeden önce webhook yüklerini, yeniden denemeleri ve senkronizasyon durumunu inceleyin.
- Erişim
- OpenAPI şartnamesini giriş yapmadan okuyabilirsiniz. Operasyonel istekler uygun tedarikçi hesabını ve yetkileri gerektirir; açık belgeler tedarikçi kaydı oluşturmaz veya başka bir tedarikçinin verilerine erişim vermez.
Makine sözleşmesi
Tedarikçi OpenAPI JSON/api/v1/supplier/openapi/v1Planlama ve istemci oluşturma için açık sözleşme. Operasyonel tedarikçi erişimi yetkilendirmeye tabidir.
04
Kurumsal Kimlik API’si
Onaylı şirket çalışma alanlarını tek oturum açmaya, kullanıcı ve grup sağlama işlemlerine ve kimlik denetim kayıtlarına bağlayın.
- Sözleşmenin kapsamı
- OpenID Connect (OIDC) tek oturum açma, SCIM kullanıcı ve grup yaşam döngüsü işlemleri, SCIM belirteci yenileme ve sağlama denetim olayları.
- Pratik bir başlangıç noktası
- Kimlik sağlayıcınızı onaylı çalışma alanına eşleyin. Giriş, kullanıcı sağlama ve erişim kaldırmayı planlayın; ardından grup eşlemelerini ve denetim kayıtlarını kararlaştırılan test ortamında doğrulayın.
- Erişim
- Kurumsal kimlik şartnamesi korumalıdır. Uygulamadan önce çalışma alanını ve erişim gereksinimlerini değerlendirmek için entegrasyon ekibiyle iletişime geçin. Normal ürün alımlarında kurumsal kimlik isteğe bağlıdır.
Makine sözleşmesi
Kurumsal kimlik OpenAPI JSON/api/v1/enterprise/identity/openapi/v1Onaylı kurumsal çalışma alanları için korumalı sözleşme; bu uç noktayı kullanmadan önce erişim isteyin.
Entegrasyon planlayın02 — Uygulama kılavuzu
Koddan önce sözleşmeyi seçin
- 01
Kullanıcı yolculuğunu belirleyin
İş akışına kimin, nereden gireceğine karar verin: gömülü mağazadaki bir alıcı, onaylı tedarikçi, kurumsal kullanıcı veya açık yetkiyle çalışan asistan.
- 02
Erişim sınırını doğrulayın
Değerlendirme ve istemci oluşturma için açık sözleşmeleri kullanın; ardından uygulamadan önce kimlik bilgilerini, kapsamları, ortamları, geri çağrıları ve korumalı uç noktaları doğrulayın.
- 03
Durum sürekliliğini kanıtlayın
Yeniden deneme ve geri alma yolları dâhil tasarım, teklif, onay, hata ve sipariş geçişlerinin entegrasyon boyunca güncel sürümde kaldığını test edin.
03 — Her entegrasyonun koruması gerekenler
Her entegrasyonun koruması gerekenler
Sürümlenmiş tek durum
Tasarım, satın alma niyeti, tedarikçi destekli teklif, onay ve sipariş durumu birbirine bağlı kalır. Eski duruma dayanan değişiklikler görünür bir yeniden teklif veya inceleme durumunu tetiklemelidir.
Ticari bilgiler ve tedarikçi gizliliği
MerchandAise, alıcıya karşı satıcı ve destek sorumlusu olarak kalır. Tedarikçi kimlikleri, iletişim bilgileri ve iç veriler açık entegrasyonlar aracılığıyla paylaşılmaz.
Üretimden önce onay
3D görünüm fiziksel kanıt değildir. Onaylı teklif, sunulan müşteri numunesi seçeneklerini, maliyetleri, sınırlamaları ve süreleri açıklar. Seri üretimden önce dijital provanın tam sürümünü onaylayın; zorunlu teknik kontrolleri ve gerekli veya seçilmiş numune onaylarını tamamlayın. Kabul edilmiş siparişlerin mevcut gereksinimleri bağlayıcıdır.
04
Üretim trafiğinden önce
Yayımlanmış bir OpenAPI dosyası planlama yüzeyidir; anonim üretim erişimi vaadi değildir. Canlıya geçmeden önce ortamları, kimlik bilgilerini, hata yönetimini ve operasyonel sorumluluğu inceleriz.
Erişim ve ortamlar
Sözleşme sürümünü, onaylı çalışma alanını, yetkilendirme kapsamlarını, test ortamını, üretim kimlik bilgilerini ve geri çağrı hedeflerini doğrulayın.
Hata ve kurtarma
Yayından önce yeniden denemeleri, idempotansı, zaman aşımlarını, müşteriye gösterilen hataları, gözlemlenebilirliği, destek sorumluluğunu ve geri almayı tanımlayın.
Uçtan uca kanıt
Amaçlanan yolculuğu girişten durum değişikliği, teklif, onay, devir ve kurtarma davranışına kadar test ortamında doğrulayın.
Sık sorulan sorular
Hangi ürün API’siyle başlamalıyım?
Kullanıcı ve durum geçişiyle başlayın. Alıcıya yönelik kulüp veya topluluk yolculukları için gömülü toplulukları, onaylı tedarikçi akışları için tedarikçi işlemlerini, SSO ve SCIM için kurumsal kimliği ve yalnızca açıkça yetkilendirilmiş yapay zekâ akışları için asistan araçlarını kullanın.
Açık sözleşme, üretim ortamına açık erişim anlamına mı gelir?
Hayır. Açık bir OpenAPI sözleşmesi keşif, mimari inceleme ve istemci oluşturmayı destekler. Üretim kimlik bilgileri, yazma işlemleri, tedarikçi akışları, kurumsal kimlik ve asistan yürütmesi yine onaylı çalışma alanı ve kapsamı belirlenmiş yetki gerektirebilir.
Entegrasyon tedarikçileri ifşa edebilir veya onayları atlayabilir mi?
Hayır. Açıklamanın zorunlu olduğu durumlar dışında tedarikçi kimliği ve iletişim bilgileri gizli kalır; alıcı ilişkisini MerchandAise yönetir. Siparişi etkileyen eylemler yapılandırılmış dijital prova, teknik kontrol ve siparişe özgü numune onayı gereksinimlerini korumalıdır.
Entegrasyonunuzu birlikte planlayalım.
Entegrasyonu kimin kullanacağını, hangi durumu okuması veya değiştirmesi gerektiğini ve deneyimin nerede yer alacağını anlatın. Sözleşmeyi, erişim modelini ve en güvenli yayına geçiş yolunu birlikte belirleyeceğiz.