{"pageKey":"Developers","slug":"developers","locale":"pt","localeResolved":"pt","fallbackApplied":false,"version":"developers@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/pt/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"Desenvolvedor API, incorporações, ferramentas MCP e integrações empresariais | MerchandAise","description":"Explore APIs de desenvolvedor MerchandAise para mercadorias personalizadas: documentos OpenAPI, incorporações de comunidade, fluxos de trabalho de fornecedores, identidade empresarial e ferramentas MCP para agentes AI.","sections":[{"heading":"Plataforma de desenvolvedor","paragraphs":["Use APIs MerchandAise, contratos OpenAPI, incorporações de comunidade, fluxos de trabalho de fornecedores, identidade empresarial e ferramentas MCP para conectar mercadorias personalizadas em sites, portais e agentes AI."]},{"heading":"Quem constrói com MerchandAise","items":[{"title":"Operadores comunitários","description":"Lance vitrines incorporadas, transferências de configuradores e fluxos comunitários dentro de sites de clubes, ligas e empresas com contratos públicos versionados."},{"title":"Equipes empresariais e parceiros de plataforma","description":"Conecte portais de compras, sistemas de identidade e operações internas a fluxos de trabalho de mercadorias sem reconstruir a aprovação e a lógica do fornecedor."},{"title":"Agente AI e construtores de automação","description":"Dê aos assistentes acesso estruturado a ferramentas para descoberta, cotação e operações aprovadas por meio de endpoints compatíveis com MCP."}]},{"heading":"Superfícies de integração e contratos","items":[{"title":"Documentos API","description":"Revise documentos legíveis por humanos e contratos OpenAPI legíveis por máquina para planejamento, testes e gerenciamento de versão com versão. Human guide: Leia a documentação da API (/pt/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: /pt/developers#api-docs."},{"title":"Incorporação da comunidade API","description":"Implemente incorporações de vitrine seguras para localidade, fluxos de trabalho comunitários e transferências autenticadas com um contrato público versionado. Human guide: Explore community workflows (/pt/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Contrato com versão pública para incorporações em vitrines, descoberta de comunidade e transferências com reconhecimento de localidade. Canonical section: /pt/developers#community-integrations."},{"title":"Fornecedor API","description":"Conecte operações de integração, catálogo e fornecedores por meio de endpoints versionados criados para fluxos de trabalho de atendimento. Human guide: Explore partner workflow (/pt/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Contrato público para planejamento e geração de clientes. O acesso operacional do fornecedor permanece permitido. Canonical section: /pt/developers#supplier-integrations."},{"title":"Identidade corporativa API","description":"Integre o provisionamento SSO, SCIM e fluxos de identidade prontos para auditoria para implementações e governança corporativa por meio de um contrato protegido para acesso empresarial aprovado. Human guide: Explore enterprise platform (/pt/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Contrato protegido para espaços de trabalho corporativos aprovados; solicite acesso antes de usar este endpoint. Canonical section: /pt/developers#enterprise-integrations."},{"title":"Ferramentas MCP","description":"Exponha recursos MerchandAise aprovados a agentes AI por meio de definições de ferramentas compatíveis com MCP detectáveis ​​e terminais de execução com autorização de assistente. Human guide: Leia o guia de implementação do MCP (/pt/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/.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: /pt/developers#mcp-tools."}]},{"heading":"Início rápido de integração","items":[{"title":"Step 1: Escolha o contrato que corresponde ao seu fluxo de trabalho","description":"Comece com a superfície que corresponde ao seu usuário e modelo de autenticação: incorporação de comunidade, identidade empresarial, operações de fornecedor ou ferramentas MCP para assistentes."},{"title":"Step 2: Valide limites de autenticação, controle de versão e ambiente","description":"Confirme os cabeçalhos, escopos, expectativas de retorno de chamada e versões do contrato necessários na preparação antes de rotear o tráfego de produção."},{"title":"Step 3: Teste fluxos de trabalho completos antes do lançamento","description":"Verifique solicitações, webhooks, provisionamento, observabilidade e caminhos de reversão para que a integração seja confiável desde o primeiro uso ao vivo."}]},{"heading":"What production-ready means","paragraphs":["Uma integração de produção precisa de mais do que um endpoint público. Use essas portas para decidir se seu fluxo de trabalho está pronto para tráfego de clientes, fornecedores, empresas ou agentes de IA."],"items":[{"title":"Sandbox and access review","description":"Confirme quais contratos são públicos, quais superfícies empresariais exigem aprovação e quais credenciais ou funções de espaço de trabalho são necessárias antes do lançamento."},{"title":"Versioned implementation evidence","description":"Mantenha os clientes gerados, URLs de retorno de chamada, escopos de autenticação, versões de contrato e propriedade de reversão documentados antes que o tráfego de produção seja habilitado."},{"title":"Operational observability","description":"Planeje registros, novas tentativas, propriedade de suporte, estados de falha e verificações de integridade para cada fluxo de trabalho que possa afetar um pedido, fornecedor ou usuário corporativo."}]},{"heading":"Precisa de uma revisão de integração?","paragraphs":["Compartilhe sua arquitetura, cronograma de implementação e canais de destino. Recomendaremos a superfície de contrato, o padrão de autenticação e a sequência de lançamento corretos."],"items":[{"title":"Fale com a equipe de integrações","description":"/pt/contact/integrations"},{"title":"Explore a plataforma empresarial","description":"/pt/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}