Afleverrapportage
Aanvragen van afleverrapportage
Ontvang afleverrapportages (delivery reports/DLR) op een door u opgegeven URL.
Bij het aanleveren van het SMS-bericht via de HTTP-API dient u de extra parameter reference mee te geven.
De toevoeging is een referentie die wij bij het afleverrapport teruggeven. Met deze variabele kunt u de afleverraporten aan een bericht koppelen. U kunt een URL opgeven op uw instellingenpagina.
| Parameter | Uitleg | Opmerkingen |
|---|---|---|
| reference | de referentie voor het rapport | maximaal 60 tekens |
Alternatieve URL
Als u een afleverrapportage wilt ontvangen op een andere URL dan dat u ingesteld heeft op uw instellingenpagina, kunt u bij het versturen van het SMS-bericht via de HTTP-API een extra parameter dlrurl meegeven. Wij zullen dan - voor dat specifieke bericht - de afleverrapportage afleveren op de opgegeven URL.
| Parameter | Uitleg | Opmerkingen |
|---|---|---|
| dlrurl | alternatieve url voor afleverrapportage | maximaal 250 tekens |
Ontvangen van afleverrapportage
U ontvangt bijvoorbeeld deze aanvraag:
http://www.domain.nl/sms/rapportage.php
?reference=123456789&recipient=31612345678
&status=50&statustime=20130520210028
De statusparameter die u ontvangt bij de rapportage, correspondeert met één van de volgende statussen:
- 50 - afgeleverd
- 51 - verstuurd
- 52 - buffered
- 53 - aflevering gefaald
- 54 - aflevering niet toegestaan/mogelijk
- 55 - bestemming uitgeschakeld
- 56 - bestemming reageert niet
- 57 - fout bij bestemming
- 58 - onvoldoende tegoed op uw SMS-account updated!
- 59 - onbekende bestemming
Let op! U kunt meerdere statusmeldingen krijgen per referentie & ontvanger. Het kan bijvoorbeeld voorkomen dat de telefoon van de ontvanger uit staat. U zult dan eerst de status 'buffered' ontvangen. Zodra het bericht daadwerkelijk afgeleverd is, ontvangt u de status 'afgeleverd'.
