{"pageKey":"Developers","slug":"developers","locale":"tr","localeResolved":"tr","fallbackApplied":false,"version":"developers@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/tr/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Geliştirici API, yerleştirmeler, MCP araçları ve kurumsal entegrasyonlar | MerchandAise","description":"Özel ürünlere yönelik MerchandAise geliştirici API'lerini keşfedin: OpenAPI belgeleri, topluluk yerleştirmeleri, tedarikçi iş akışları, kurumsal kimlik ve AI aracıları için MCP araçları.","sections":[{"heading":"Geliştirici platformu","paragraphs":["Özel ürünleri web sitelerine, portallara ve AI aracılarına bağlamak için MerchandAise API'lerini, OpenAPI sözleşmelerini, topluluk yerleştirmelerini, tedarikçi iş akışlarını, kurumsal kimliği ve MCP araçlarını kullanın."]},{"heading":"MerchandAise ile kimler inşaat yapar?","items":[{"title":"Topluluk operatörleri","description":"Sürümlendirilmiş kamu sözleşmeleriyle kulüp, lig ve şirket siteleri içinde yerleşik vitrinler, yapılandırıcı aktarımları ve topluluk akışları başlatın."},{"title":"Kurumsal ekipler ve platform ortakları","description":"Onay ve tedarikçi mantığını yeniden oluşturmaya gerek kalmadan satın alma portallarını, kimlik sistemlerini ve dahili operasyonları ürün iş akışlarına bağlayın."},{"title":"AI aracısı ve otomasyon oluşturucuları","description":"MCP uyumlu uç noktalar aracılığıyla asistanlara keşif, fiyat teklifi verme ve onaylı işlemler için yapılandırılmış araç erişimi sağlayın."}]},{"heading":"Entegrasyon yüzeyleri ve sözleşmeleri","items":[{"title":"API belgeleri","description":"Planlama, test etme ve sürüm yönetimi için insan tarafından okunabilen belgeleri ve makine tarafından okunabilen OpenAPI sözleşmelerini inceleyin. Human guide: Read API docs (/tr/developers/api-integrations). Machine-readable contract: OpenAPI JSON (/api/docs/openapi.json). Access: public. Public reference for assistant and tooling APIs. Production access and order-affecting operations still require the applicable authorization. Canonical section: /developers#api-docs."},{"title":"Topluluk gömülü API","description":"Sürümü belirlenmiş bir genel sözleşmeyle yerel ayarlarda güvenli vitrin yerleştirmeleri, topluluk iş akışları ve kimliği doğrulanmış aktarımlar uygulayın. Human guide: Explore community workflows (/tr/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Public versioned contract for storefront embeds, community discovery, and locale-aware handoffs. Canonical section: /developers#community-integrations."},{"title":"Tedarikçi API","description":"Yerine getirme iş akışları için oluşturulmuş versiyonlu uç noktalar aracılığıyla katılım, katalog ve tedarikçi tarafı operasyonlarını birbirine bağlayın. Human guide: Explore partner workflow (/tr/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Public contract for planning and client generation. Operational supplier access remains permissioned. Canonical section: /developers#supplier-integrations."},{"title":"Kurumsal kimlik API","description":"Onaylanmış kurumsal erişim için korumalı bir sözleşme aracılığıyla kurumsal kullanıma sunma ve yönetim için SSO, SCIM sağlama ve denetime hazır kimlik akışlarını entegre edin. Human guide: Explore enterprise platform (/tr/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Protected contract for approved enterprise workspaces; request access before using this endpoint. Canonical section: /developers#enterprise-integrations."},{"title":"MCP araçları","description":"Onaylanmış MerchandAise yeteneklerini, keşfedilebilir MCP uyumlu araç tanımları ve asistan yetkilendirmesi ile yürütme uç noktaları aracılığıyla AI aracılarına sunun. Human guide: Read MCP implementation guide (/tr/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/tr/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The external tools list at /api/v1/mcp/tools exposes current tool metadata; each tool call still follows its declared security, workspace, and confirmation boundaries. Canonical section: /developers#mcp-tools."}]},{"heading":"Entegrasyon hızlı başlangıcı","items":[{"title":"Step 1: İş akışınıza uygun sözleşmeyi seçin","description":"Kullanıcı ve kimlik doğrulama modelinizle eşleşen yüzeyle başlayın: topluluk yerleştirmesi, kurumsal kimlik, tedarikçi işlemleri veya asistanlar için MCP araçları."},{"title":"Step 2: Kimlik doğrulama, sürüm oluşturma ve ortam sınırlarını doğrulama","description":"Üretim trafiğini yönlendirmeden önce hazırlamada gerekli başlıkları, kapsamları, geri arama beklentilerini ve sözleşme sürümlerini doğrulayın."},{"title":"Step 3: Lansmandan önce uçtan uca iş akışlarını test edin","description":"Entegrasyonun ilk canlı kullanımdan itibaren güvenilir olması için istekleri, web kancalarını, sağlamayı, gözlemlenebilirliği ve geri alma yollarını doğrulayın."}]},{"heading":"What production-ready means","paragraphs":["A production integration needs more than a public endpoint. Use these gates to decide whether your workflow is ready for customer, supplier, enterprise, or AI-agent traffic."],"items":[{"title":"Sandbox and access review","description":"Confirm which contracts are public, which enterprise surfaces require approval, and which credentials or workspace roles are needed before launch."},{"title":"Versioned implementation evidence","description":"Keep generated clients, callback URLs, auth scopes, contract versions, and rollback ownership documented before production traffic is enabled."},{"title":"Operational observability","description":"Plan logs, retries, support ownership, failure states, and health checks for every workflow that can affect an order, supplier, or enterprise user."}]},{"heading":"Entegrasyon incelemesine mi ihtiyacınız var?","paragraphs":["Mimarinizi, kullanıma sunma zaman çizelgenizi ve hedef kanallarınızı paylaşın. Doğru sözleşme yüzeyini, kimlik doğrulama modelini ve başlatma sırasını önereceğiz."],"items":[{"title":"Entegrasyon ekibiyle konuşun","description":"/tr/contact/integrations"},{"title":"Kurumsal platformu keşfedin","description":"/tr/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}