# Ü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.
Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order.

## 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). Erişim: Herkese açık. 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). Erişim: Herkese açık. 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). Erişim: Herkese açık. 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). Erişim: Korumalı. 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:** A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding.

## 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?:** No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements.

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