MMS HTTP-API (Full)
Versturen via de HTTP-API
Er zijn twee manieren om MMS via mollie te versturen. De meest eenvoudige manier is via onze Easy-MMS HTTP-API, deze werkt vrijwel hetzelfde als onze SMS HTTP-API. Wilt u uw MMS zelf volledig opmaken en designen, dan kunt u de Full-MMS HTTP-API gebruiken.
MMS HTTP-API (Full)
De Full-MMS-gateway verstuurt altijd een normaal MMS-bericht (geen WAP-push-MMS). Bij onze Full-MMS-API levert u via een POST-HTTP-request een XML-document aan met alle benodigde parameters. Het XML-document bevat onder andere de MMS-opmaak, teksten en bijlagen (foto of video). De MMS maakt u op volgens SMIL, een speciale Markup taal voor Multimedia berichten zoals MMS. De MMS-opmaak, teksten en bijlagen voegt u base64 geëncodeerd toe aan de XML code.
Hieronder vindt u een voorbeeld van een MMS-XML-aanvraag, deze levert u als body per POST-HTTP-request aan op http://www.mollie.nl/xml/mms/.
Post zo de aanvraag:
<?xml version="1.0" encoding="UTF-8" ?>
<mms_message>
<username>[gebruikersnaam]</username>
<password>[wachtwoord]</password>
<subject>[onderwerp]</subject>
<originator>[afzender]</originator>
<recipients>
<recipient>[ontvanger]</recipient>
<recipient>[ontvanger]</recipient>
<recipient>[ontvanger]</recipient>
</recipients>
<parts>
<part>
<content_name>0001</content_name>
<content_type>application/smil</content_type>
<content_body>[SMIL base64 ge-encode]</content_body>
</part>
<part>
<content_name>body.txt</content_name>
<content_type>text/plain</content_type>
<content_body>[tekst base64 ge-encode]</content_body>
</part>
<part>
<content_name>mollie_logo.gif</content_name>
<content_type>image/gif</content_type>
<content_body>[afbeelding base64 ge-encode]</content_body>
</part>
</parts>
</mms_message>
| Parameter | Uitleg | Opmerkingen |
|---|---|---|
| username | uw gebruikersnaam op Mollie.nl | |
| password | uw wachtwoord op Mollie.nl | |
| subject | het onderwerp | maximaal 25 tekens |
| originator | afzender van het bericht | maximaal 18 cijfers (géén tekens) |
| recipients | ontvanger(s) van het MMS-bericht | container voor ontvangers |
| recipient | ontvanger van het MMS-bericht | |
| parts | berichtonderdelen | container voor de berichtonderdelen |
| part | berichtonderdeel | container voor de onderdeeleigenschappen |
| content_name | bestandsnaam van berichtonderdeel | SMIL dient altijd 0001 te heten |
| content_type | MIME type van berichtonderdeel | meer info |
| content_body | body van berichtonderdeel | base64 encoded body |
| Optionele parameters | ||
| md5_password | uw ge-encrypte Mollie-wachtwoord | in plaats van password gebruiken |
Na het sturen van de HTTP-request geeft onze server een XML-resultaat terug. Hieronder vind je een voorbeeld:
<?xml version="1.0" ?>
<response>
<item type="mms">
<recipients>1</recipients>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Message successfully
sent.</resultmessage>
</item>
</response>
SMIL voorbeeld
Hieronder vindt u een voorbeeld van een SMIL layout. Deze SMIL verwijst naar een text en een afbeelding, die meegestuurd dienen te worden als part (berichtonderdeel).
<smil>
<body>
<par>
<text src="body.txt" />
<img src="mollie_logo.gif" />
</par>
</body>
</smil>