{"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: Read API docs (/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: /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. Public versioned contract for storefront embeds, community discovery, and locale-aware handoffs. Canonical section: /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. Public contract for planning and client generation. Operational supplier access remains permissioned. Canonical section: /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. Protected contract for approved enterprise workspaces; request access before using this endpoint. Canonical section: /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: Read MCP implementation guide (/pt/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/pt/.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":"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":["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":"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"}}