MMS HTTP-API (Easy)
Versturen via de HTTP-API
Er zijn twee manieren om MMS aan mollie aan te bieden. 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 (Easy)
Onze Easy MMS API werkt middels een HTTP request. Wanneer u een HTTP request naar onze server stuurt, kunt u met behulp van POST of GET variabelen de waarden meesturen. Bijvoorbeeld de afzender, het bericht en de ontvangers. Gebruik onderstaande URL voor het versturen van MMS berichten:
Post zo de aanvraag:
http://www.mollie.nl/xml/mms/?username=[username] &password=[password]&gateway=[1/2]&originator=[originator] &recipients=[recipient(s)]&subject=[subject] &message=[message]&attachment[1]=[url_to_attachment]
| Parameter | Uitleg | Opmerkingen |
|---|---|---|
| username | mollie.nl gebruikersnaam | |
| password | mollie.nl wachtwoord | |
| originator | afzender van het bericht | maximaal 18 cijfers (géén tekens) |
| recipients | ontvanger(s) van het MMS-bericht | nummers scheiden met komma |
| subject | het onderwerp | maximaal 25 tekens |
| message | het bericht | maximaal 1000 tekens |
| Optionele parameters | ||
| md5_password | uw mollie wachtwoord ge-encrypt | in plaats van password gebruiken |
| gateway | type MMS-route | 1: Normaal MMS; 2: Wappush MMS |
| attachment[1] | URL van het attachment | bijvoorbeeld: 'http://www.uwsite.nl/plaatje.jpg' |
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>
Het item recipients geeft in het geval dat het versturen gelukt is het aantal telefoonnummers waarnaar het bericht verstuurd is aan. Nummers die duidelijk geen telefoonnummer zijn worden door ons systeem gefilterd.
Het item success geeft simpelweg aan of het versturen gelukt is of niet, dit staat gelijk met of resultcode op 10 (success=true) staat of niet.
Mogelijke resultaten uit resultcode:
- 10 - succesvol verzonden
- 20 - geen 'username' opgegeven
- 21 - geen 'password' opgegeven
- 22 - geen of onjuiste 'originator' opgegeven
- 23 - geen 'recipients' opgegeven
- 24 - geen 'message' opgegeven
- 25 - geen juiste 'recipients' opgegeven
- 26 - geen juiste 'originator' opgegeven
- 27 - geen juiste 'message' opgegeven
- 29 - andere parameter fout
- 30 - incorrecte 'username' of 'password'
- 31 - onvoldoende credits om te versturen
- 98 - gateway onbereikbaar
- 99 - onbekende fout
NB: mobiele telefoons van operators die geen MMS ondersteunen, krijgen (als u via gateway 2 verstuurd) een WAP-push toegestuurd met een URL waar ze het MMS bericht alsnog kunnen bekijken.
MMS API voorbeelden
Hieronder hebben we voor u een simpel voorbeeld klaar staan.
| Omschrijving | Programmeertaal | Auteur | Versie |
|---|---|---|---|
| PHP class (Easy MMS) | PHP 5.x of hoger | Mollie | v2.3 (17/06/09) |