# Centro de programadores: API, OpenAPI e MCP | MerchandAise

- slug: developers
- locale: pt
- localeResolved: pt
- canonical: https://www.merchandaise.com/pt/developers

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.

## Centro de programadores MerchandAise
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.

## Para os sistemas à volta do seu programa de merchandising
- **Gestores de comunidades:** 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.
- **Equipas empresariais e parceiros de plataforma:** 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.
- **Criadores de agentes de IA e automação:** 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.

## Encontre a sua integração
- **Documentação API e OpenAPI:** 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.
- **API de comunidades:** 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.
- **API de fornecedores:** 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.
- **API de identidade empresarial:** 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.
- **Agentes de IA e MCP:** 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.

## Do primeiro pedido à produção
- **Step 1: Escolha o contrato adequado ao percurso:** 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.
- **Step 2: Valide os limites de autenticação, versões e ambientes:** 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.
- **Step 3: Teste os percursos completos antes de lançar:** 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.

## O que significa estar pronto para produção
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.
- **Análise do ambiente de teste e do acesso:** 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.
- **Provas de implementação com versões:** 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.
- **Observabilidade operacional:** 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.

## Antes de começar a desenvolver
- **Que API da MerchandAise devo usar?:** 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.
- **Posso ler as especificações API sem uma conta?:** 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.
- **Preciso de uma integração técnica para encomendar um produto?:** 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.
- **O que devo incluir num pedido de integração?:** 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.

## Está a planear uma integração personalizada?
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.
- **Fale sobre uma integração:** /pt/contact/integrations
- **Explore soluções para empresas:** /pt/enterprise
