MAPI
Concept
MAPI (Messaging Application Programming Interface) é uma API de mensagens proprietária da Microsoft e um modelo de dados que sustenta o Exchange e o Outlook, cujas estruturas de dados legadas ainda moldam o desenvolvimento para o Exchange.
Descrição
MAPI, sigla de Messaging Application Programming Interface, é uma API de mensagens proprietária da Microsoft e um modelo de dados que sustenta o Exchange e o Outlook. Suas estruturas de dados legadas ainda influenciam a forma como os desenvolvedores trabalham com os dados do Exchange hoje, mesmo quando usam interfaces mais novas para acessá-los. O termo é usado tanto para a própria interface de programação quanto para a forma como o conteúdo das caixas de correio é modelado por baixo dela.
De acordo com a referência do Microsoft Learn, MAPI é a API de mensagens do Microsoft Outlook e fornece a arquitetura de mensagens para o Outlook 2013 e o Outlook 2016. Ela oferece interfaces, funções e tipos de dados que os desenvolvedores usam para criar aplicativos de mensagens para o Outlook. Aplicativos e transportes usam o MAPI para trabalhar com dados de e-mail, criar mensagens e as pastas que as armazenam e receber notificações quando os dados relacionados ao MAPI são alterados. A página de referência se aplica apenas ao Outlook 2013 e ao Outlook 2016 e não lista interfaces, funções individuais nem exemplos de código.
A referência do Microsoft Learn está organizada em quatro partes: uma visão geral para começar, aplicativos de exemplo, guias conceituais para entender e programar com o MAPI e a referência de seus elementos de programação. Para desenvolvedores que são novos na área, a página aponta para um artigo separado sobre como selecionar a API ou tecnologia adequada para desenvolver soluções para o Outlook. Essa orientação reflete uma decisão comum: o MAPI é uma opção entre várias, e a escolha depende do tipo de solução que está sendo construída.
Na prática, o MAPI tem mais importância quando o código existente precisa ser migrado para tecnologias mais novas. O episódio do M365.FM "Migrate Exchange Web Services to Microsoft Graph with Glen Scales [MVP]" aborda esse tema. O episódio observa que alguns fluxos de trabalho exigem atenção especial ao migrar do Exchange Web Services para o Microsoft Graph, especialmente aqueles que envolvem caixas de correio de arquivo ou pastas públicas. Também diz que criar e-mails a partir de MIME bruto com propriedades estendidas do MAPI pode exigir a reformulação de um fluxo de trabalho, porque essa abordagem não se transfere sem alterações. A semântica avançada de delta é listada como outra diferença entre EWS e Graph que pode exigir retrabalho de partes do código.
O episódio apresenta esses pontos como uma tabela de desafios de migração: o acesso a caixas de correio de arquivo e algumas tarefas de importação e exportação de caixas de correio exigem atenção especial, cenários de pastas públicas exigem contato com a Microsoft para verificar dependências, e a semântica avançada de delta difere entre as duas APIs. As propriedades estendidas do MAPI aparecem nessa lista porque são um dos pontos em que o modelo de dados mais antigo vaza para o código das aplicações, de modo que as equipes que dependem delas precisam revisar essas partes de uma migração separadamente.
Para administradores e desenvolvedores, a consequência prática é que o conhecimento sobre MAPI continua relevante para ler código mais antigo do Exchange e do Outlook, para entender como mensagens, pastas e notificações são estruturadas e para avaliar o esforço de uma migração para o Microsoft Graph. Como as fontes disponíveis descrevem o MAPI principalmente no contexto do Outlook 2013 e do Outlook 2016 e da migração de EWS para Graph, quem planeja qualquer trabalho deve confirmar o suporte atual e os requisitos na documentação oficial para o cenário específico.
Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.
| Tipo | Concept |
|---|---|
| Wikipédia | MAPI – Wikipedia en.wikipedia.org |
Perguntas frequentes
Questions marked with AI were written with AI from the facts on this page.
O que é MAPI? (AI)
MAPI (Messaging Application Programming Interface) é uma API de mensagens proprietária da Microsoft e um modelo de dados que sustenta o Exchange e o Outlook. O Microsoft Learn a descreve como a fornecedora da arquitetura de mensagens para o Outlook 2013 e o Outlook 2016.
O que os aplicativos podem fazer com o MAPI? (AI)
Aplicativos e transportes usam o MAPI para trabalhar com dados de e-mail, criar mensagens e as pastas que as armazenam e receber notificações quando os dados relacionados ao MAPI são alterados.
Por que o MAPI aparece nas migrações do Exchange Web Services para o Microsoft Graph? (AI)
O episódio "Migrate Exchange Web Services to Microsoft Graph with Glen Scales [MVP]" diz que criar e-mails a partir de MIME bruto com propriedades estendidas do MAPI pode exigir a reformulação de fluxos de trabalho ao migrar para o Graph.
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Especialistas e empresas para este tópico
Ninguém indicou ainda este tópico. Adicione-o ao seu perfil.
Sources
- MAPI – Wikipedia en.wikipedia.org
- Outlook MAPI Reference – Microsoft Learn learn.microsoft.com
Maintained by Mirko Peters (Microsoft MVP) · Last updated: