# Ürün API ve entegrasyon sözleşmeleri | MerchandAise

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

Asistan araçları, topluluk yerleştirmeleri, tedarikçi operasyonları ve kurumsal kimlik için net genel ve korumalı erişim sınırlarına sahip MerchandAise sözleşmelerini keşfedin.

## 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.

## 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. Human guide: Asistan araçları belgelerini aç (/tr/developers/api-integrations). Machine-readable contract: Asistan araçları OpenAPI JSON (/api/docs/openapi.json). Access: public. 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. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **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. Human guide: Topluluk entegrasyon kılavuzunu inceleyin (/tr/developers/api-integrations#community-integrations). Machine-readable contract: Topluluk OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Mağaza yerleştirmeleri, topluluk keşfi ve yerel ayarlara duyarlı süreç aktarımları için genel sürümlendirilmiş sözleşme. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **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. Human guide: Tedarikçi entegrasyon kılavuzunu inceleyin (/tr/developers/api-integrations#supplier-integrations). Machine-readable contract: Tedarikçi OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Planlama ve istemci oluşturma için genel sözleşme. Operasyonel tedarikçi erişimi izne tabi olmaya devam eder. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **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. Human guide: Kurumsal entegrasyon kılavuzunu inceleyin (/tr/developers/api-integrations#enterprise-integrations). Machine-readable contract: Kurumsal kimlik OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Onaylı kurumsal çalışma alanları için korumalı sözleşme; bu uç noktayı kullanmadan önce erişim talep edin. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Koddan önce sözleşmeyi seçin
- **Step 1: 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.
- **Step 2: 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.
- **Step 3: 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:** 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:** /tr/contact?intent=api-integration-review
- **AI ajanlarını ve MCP'yi keşfedin:** /tr/developers/ai-agents-mcp