{"pageKey":"Developers","slug":"developers","locale":"pt","localeResolved":"pt","fallbackApplied":false,"version":"developers@2026-11-22T22:05:42.555Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/pt/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Centro de programadores: API, OpenAPI e MCP | MerchandAise","description":"Crie integrações de merchandising personalizado com as API da MerchandAise. Explore documentação OpenAPI, comunidades incorporadas, percursos de fornecedores, SSO empresarial e ferramentas MCP.","sections":[{"heading":"Centro de programadores MerchandAise","paragraphs":["Ligue o seu site, sistemas empresariais ou assistente de IA à MerchandAise. Explore API para design de produtos, lojas de comunidades, operações de fornecedores e identidade empresarial, com especificações OpenAPI e documentação MCP para orientar a integração."]},{"heading":"Para os sistemas à volta do seu programa de merchandising","items":[{"title":"Gestores de comunidades","description":"Lance lojas incorporadas, passagens para o configurador e percursos de comunidade nos sites de clubes, ligas e empresas com contratos públicos com versões."},{"title":"Equipas empresariais e parceiros de plataforma","description":"Ligue portais de compras, sistemas de identidade e operações internas a percursos de merchandising sem recriar a lógica de aprovação e fornecedores."},{"title":"Criadores de agentes de IA e automação","description":"Dê aos assistentes acesso estruturado a ferramentas de descoberta, orçamentos e operações aprovadas através de pontos de acesso compatíveis com MCP."}]},{"heading":"Encontre a sua integração","items":[{"title":"Documentação API e OpenAPI","description":"Encontre a referência API para ferramentas de assistentes e sessões de design. Depois, escolha o contrato de comunidade, fornecedor ou empresa para o seu percurso. Human guide: Explore a documentação API (/pt/developers/api-integrations). Machine-readable contract: OpenAPI das ferramentas de assistentes em JSON (/api/docs/openapi.json). Access: public. Referência pública para API de assistentes e ferramentas. O acesso de produção e as operações que afetam encomendas continuam a exigir a autorização aplicável. Canonical section: /pt/developers#api-docs."},{"title":"API de comunidades","description":"Ligue o site de um clube ou comunidade a informação pública da comunidade, envio de designs, votação e passagens para aprovação de encomendas. Human guide: Explore a API de comunidades (/pt/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI de comunidades em JSON (/api/v1/community/public/openapi/v1). Access: public. Contrato público com versões para lojas incorporadas, descoberta de comunidades e passagens que preservam o idioma. Canonical section: /pt/developers#community-integrations."},{"title":"API de fornecedores","description":"Ligue sistemas de fornecedores aprovados a pacotes de produção disponibilizados, estado de adesão e percursos de webhooks ERP ou PLM. Human guide: Explore a API de fornecedores (/pt/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI de fornecedores em JSON (/api/v1/supplier/openapi/v1). Access: public. Contrato público para planeamento e geração de clientes. O acesso operacional de fornecedores continua sujeito a permissões. Canonical section: /pt/developers#supplier-integrations."},{"title":"API de identidade empresarial","description":"Ligue espaços empresariais aprovados ao início de sessão único, ao aprovisionamento de utilizadores e grupos e aos registos de auditoria de identidade. Human guide: Explore a identidade empresarial (/pt/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI de identidade empresarial em JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Contrato protegido para espaços empresariais aprovados; peça acesso antes de usar este ponto de acesso. Canonical section: /pt/developers#enterprise-integrations."},{"title":"Agentes de IA e MCP","description":"Ligue um assistente de IA através do Model Context Protocol. Descubra ferramentas compatíveis e preserve as escolhas de design, as permissões e as confirmações exigidas do utilizador. Human guide: Explore agentes de IA e MCP (/pt/developers/ai-agents-mcp). Machine-readable contract: Ficha pública do servidor MCP em JSON (/.well-known/mcp/server-card). Access: public. Documento público de descoberta para clientes automáticos. A lista externa de ferramentas em /api/v1/mcp/tools expõe os metadados atuais; cada chamada continua sujeita aos limites declarados de segurança, espaço de trabalho e confirmação. Canonical section: /pt/developers#mcp-tools."}]},{"heading":"Do primeiro pedido à produção","items":[{"title":"Step 1: Escolha o contrato adequado ao percurso","description":"Comece pela interface adequada ao seu utilizador e modelo de autenticação: comunidade incorporada, identidade empresarial, operações de fornecedores ou ferramentas MCP para assistentes."},{"title":"Step 2: Valide os limites de autenticação, versões e ambientes","description":"Confirme os cabeçalhos exigidos, os âmbitos, os requisitos de callback e as versões de contrato em pré-produção antes de encaminhar tráfego de produção."},{"title":"Step 3: Teste os percursos completos antes de lançar","description":"Verifique os pedidos, webhooks, aprovisionamento, observabilidade e percursos de reversão para que a integração seja fiável desde a primeira utilização real."}]},{"heading":"O que significa estar pronto para produção","paragraphs":["Uma integração de produção precisa de mais do que um ponto de acesso público. Use estas verificações para decidir se o percurso está pronto para tráfego de clientes, fornecedores, empresas ou agentes de IA."],"items":[{"title":"Análise do ambiente de teste e do acesso","description":"Confirme que contratos são públicos, que interfaces empresariais exigem aprovação e que credenciais ou funções de espaço são necessárias antes do lançamento."},{"title":"Provas de implementação com versões","description":"Documente os clientes gerados, endereços de callback, âmbitos de autenticação, versões de contrato e responsabilidade de reversão antes de ativar tráfego de produção."},{"title":"Observabilidade operacional","description":"Planeie registos, novas tentativas, responsabilidade de apoio, estados de falha e verificações de funcionamento para cada percurso que possa afetar uma encomenda, um fornecedor ou um utilizador empresarial."}]},{"heading":"Antes de começar a desenvolver","items":[{"title":"Que API da MerchandAise devo usar?","description":"Use a API de comunidades para percursos de sites de clubes e comunidades, a API de fornecedores para operações de fornecedores aprovados e a API de identidade empresarial para início de sessão e aprovisionamento de empresas. A referência API abrange ferramentas de assistentes; o guia MCP explica como os assistentes de IA descobrem e utilizam ferramentas compatíveis."},{"title":"Posso ler as especificações API sem uma conta?","description":"As especificações OpenAPI de ferramentas de assistentes, comunidades e fornecedores são públicas. A especificação de identidade empresarial é protegida. Ler uma especificação pública não dá permissão para executar pedidos protegidos nem fazer encomendas."},{"title":"Preciso de uma integração técnica para encomendar um produto?","description":"Não. Pessoas, clubes e empresas podem usar o site da MerchandAise para explorar produtos compatíveis e pedir um orçamento. As API são uma forma opcional de ligar os seus próprios sistemas ou experiência."},{"title":"O que devo incluir num pedido de integração?","description":"Descreva quem irá utilizá-la, os sistemas envolvidos, a informação que precisa de ler ou atualizar e os prazos pretendidos. Inclua os requisitos de início de sessão, ambiente e callback, se conhecidos. A equipa analisa consigo o contrato e modelo de acesso adequados."}]},{"heading":"Está a planear uma integração personalizada?","paragraphs":["Partilhe os sistemas envolvidos, o percurso que pretende apoiar e os prazos de lançamento. Ajudamos a escolher o contrato, o modelo de acesso e a sequência de lançamento adequados."],"items":[{"title":"Fale sobre uma integração","description":"/pt/contact/integrations"},{"title":"Explore soluções para empresas","description":"/pt/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}