View source for MAPI

{{Short description|Microsoft Windows email API}}
{{distinguish|Manufacturers Alliance for Productivity and Innovation|IMAP}}
{{for|the Israeli government agency|Survey of Israel}}
'''Messaging Application Programming Interface''' ('''MAPI''') is an [[Application programming interface|API]] for [[Microsoft Windows]] which allows programs to become [[email]]-aware. While MAPI is designed to be independent of the protocol, it is usually used to communicate with [[Microsoft Exchange Server]].<ref>{{cite web |url=https://technet.microsoft.com/en-us/library/dn635177(v=exchg.160).aspx |title=MAPI over HTTP in Exchange 2016 |date=2016-12-20 |website=[[Microsoft TechNet]] }}</ref>

== Details ==
MAPI uses functions loosely based on the [[X.400]] XAPIA standard.  It includes facilities to access [[Mail transfer agent|message transport]]s, message stores, and [[Directory services|directories]].

While ''Simple MAPI'' (SMAPI) is a subset of 12 functions which enable developers to add basic messaging functionality, ''Extended MAPI'' (EMAPI) allows complete control over the messaging system on the client computer. This includes creation and management of messages, plus management of the client mailbox, and service providers. 

Simple MAPI is included with [[Microsoft Windows]] as part of [[Outlook Express]]/[[Windows Mail]] while the full Extended MAPI is included with [[Microsoft Outlook]] and [[Microsoft Exchange Server|Exchange]].

In addition to the Extended MAPI client interface, programming calls can be made indirectly through the Simple MAPI API client interface, through the ''Common Messaging Calls'' (CMC) API client interface, or by the object-based ''[[Collaboration Data Objects|CDO]] Library'' interface.  These three methods are easier to use and designed for less complex messaging-enabled and -aware applications. (Simple MAPI and CMC were removed from Exchange 2003.)

MAPI was originally designed by [[Microsoft]].  The company founded its MS Mail team in 1987, but it was not until it acquired [[Consumers Software]] in 1991 to obtain ''Network Courier'' that it had a messaging product. Reworked, it was sold as MS PC Mail (or [[Microsoft Mail]] for PC Networking).  The basic API to MS PC Mail was later known as MAPI version 0 (or ''MAPI0''), to differentiate it from "true" MAPI.

== Service provider interface ==
The full Extended MAPI interface is required for interfacing messaging-based services to client applications such as Outlook. For example, several non-Microsoft e-mail server product vendors created "MAPI service providers" to allow their products to be accessed via Outlook. Notable examples include [[Axigen|Axigen Mail Server]], [[Kerio Connect]], [[Scalix]], [[Zimbra]], [[HP OpenMail]], [[IBM Lotus Notes]], [[Zarafa (software)|Zarafa]]/[[Kopano (software)|Kopano]], and [[Bynari]].

MAPI also had a service provider interface of sorts.  Microsoft used this to interface MS Mail to an email system based on [[Xenix]], for internal use.

Extended MAPI is the main e-mail data access method used by Outlook, to interface to Microsoft Exchange, via MAPI service providers shipped with Outlook.

== MAPI/RPC protocol details ==
Microsoft has released full details of the MAPI/RPC protocol since August 2007.<ref>[http://msdn.microsoft.com/en-us/library/cc307725(EXCHG.80).aspx Exchange Server Protocols]. Msdn.microsoft.com. Retrieved on 2013-07-17.</ref>

"MAPI protocol" is a colloquial name for the MAPI/RPC.  At times, Microsoft has also called it "Exchange RPC" and "Outlook-Exchange Transport Protocol".

Microsoft provides a sample MAPI/RPC-based application called MFCMAPI<ref>[https://github.com/stephenegriffin/mfcmapi Mfcmapi - Home]. https://github.com/stephenegriffin/mfcmapi. Retrieved on 2017-07-26.</ref> to assist developers. It is also widely used as a diagnostics tool by both developers and Microsoft Exchange administrators.

==MAPI over HTTP==
The original implementation was designed for use on a local network, or [[LAN]].

With Exchange 2003 and Outlook 2010, Microsoft introduced RPC over HTTP (later renamed Outlook Anywhere) as a way to Exchange over the internet.<ref>{{cite web|date=2014-12-22|title=Exchange Server 2003 RPC over HTTP Deployment Scenarios|url=http://technet.microsoft.com/en-us/library/aa998950(EXCHG.65).aspx|url-status=dead|access-date=2014-12-22|archive-url=https://web.archive.org/web/20141222104318/http://technet.microsoft.com/en-us/library/aa998950(EXCHG.65).aspx|archive-date=2014-12-22}}</ref>

In 2014, Exchange 2013 SP1 introduced another variant, this time with a more "normal" HTTP-based stack known as "MAPI over HTTP".<ref>{{cite web|title=Outlook Connectivity with MAPI over HTTP|url=https://blogs.technet.microsoft.com/exchange/2014/05/09/outlook-connectivity-with-mapi-over-http/|url-status=dead|access-date=20 April 2019|website=You Had Me At EHLO…|publisher=Microsoft|archive-url=https://web.archive.org/web/20190420173148/https://blogs.technet.microsoft.com/exchange/2014/05/09/outlook-connectivity-with-mapi-over-http/|archive-date=2019-04-20}}</ref>

== Incompatibility with Internet Mail ==
The [[Simple Mail Transfer Protocol]] has always supported the concept of mail with multiple authors, and distinguishes between the "sender" and "authors" whenever there is more than one of the latter. MAPI cannot represent separate authors and senders except through the delegation mechanism, which does not permit more than one author.  Thus MAPI cannot accurately transmit group letters from scientific communities to legislators, or presentation of group research via email, or similar scenarios.  When fully SMTP compliant mailers (e.g. [[Mozilla_Thunderbird|Thunderbird]]) send perfectly formed SMTP messages with multiple authors into MAPI-dependent email infrastructures (such as Exchange/Outlook, O365, or Outlook.com) the messages must have their information density reduced to fit MAPI, presenting challenges for authentication and anti-spoofing technologies that rely on accurate message metadata transmission, and fundamentally changing messages to be something other than what was originally sent. Although the security implications impact all users, inability to represent multiple authorship is generally of little concern in purely hierarchical settings such as traditional businesses and military organizations, primarily impacting legislative and academic institutions.

== Reimplementations ==
Several [[open-source software project]]s have started working on implementing MAPI libraries, including:

* Grommunio/Gromox has C++20 implementations of MAPI/RPC and MAPI/HTTP servers.
* The OpenMapi project (now demised)<ref>openmapi.org used to host the downloads; it no longer exists</ref> had a C# implementation.
* [[Kopano (software)|Kopano]] Groupware Core has a C++2011 implementation called "mapi4linux" (continuation of the same from [[Zarafa (software)|Zarafa]]), which offers an API that is source-backwards-compatible with the Messaging API (code written for M4L also build with the Windows SDK). Kopano GWC comes with a connector for the Zarafa/Kopano-based SOAP/HTTP transport.
* [[OpenChange]] has a "libmapi" component written in C that only partially resembles MAPI. (Lacks interfaces like IMsgStore, the OpenEntry function.)
* The OpenChange subproject [[Evolution-MAPI]] is a connector for Exchange implementing the MAPI/RPC transport.
* The GNOME [[Evolution (software)|Evolution project]] develops ''evolution-ews'', which has implemented much of MAPI.<ref>{{cite web |title=EWS Operations Features' Parity Matrix |url=https://wiki.gnome.org/Apps/Evolution/EWS_OperationsFeaturesParityMatrix |access-date=17 December 2018}}</ref>

== References ==
{{reflist}}

== External links ==
*[http://msdn.microsoft.com/en-us/library/cc765775.aspx Messaging API at MSDN Library]
*[https://web.archive.org/web/20040928063012/http://www.openchange.org/ OpenChange project - details of MAPI protocol and tools for exploring MAPI protocol]
*[https://launchpad.net/openmapi/ OpenMapi project - Open Source, multi-language MAPI implementation which can connect to other groupware sources, with API documentation]
*[https://web.archive.org/web/20090220065008/http://www.techienuggets.com/Articles?tx=16 Messaging API Archived User Forum]
*[http://www.mailenable.com/kb/Content/Article.asp?ID=me020589 Enabling Outlook Connector logging for support]

{{Microsoft APIs}}

[[Category:Internet mail protocols]]
[[Category:Microsoft application programming interfaces]]