HTTP MODTAGELSE

Dette dokument beskriver bruger af Modtagelse af SMS via HTTP POST.

Vores service er baseret på at en modtaget besked sendes videre til kundens egen webserver, der herefter kan udvikle sine egne tjenester.

Kunden specificere server samt adresse der skal sendes til i vores webinterface.

Når en besked modtages, og skal sendes videre til kunden, bliver den sendt som et HTTP POST kald med følgende parametre:

FROM	Afsenderen af beskeden i internationalt nummer format, f.eks. 4512345678
SMS	Selve beskeden som er modtaget.
NUMBER	Applikationskoden eller GSM Nummeret beskeden er modtaget på.

Når en MMS modtages, sendes der en række ekstra parametere med. Dog vil parametret MESSAGE indeholde det første tekst element i MMS'en, medmindre dette er tomt, så indeholder det MMS emnet. Dette gør, at hvis ens tjeneste kun er lavet til at håndtere MMS, vil den også virke når man modtager en SMS, uden at man skal analysere de ekstra parametre.
Sendes en MMS, vil forespørgslen indeholde disse ekstra parametret

TYPE	Denne er altid sat til MMS
SUBJECT	Indeholder emnefeltet af MMS Beskeden.
ATTACHMENT[]	Dette parameter kan forekomme flere gange, afhængig af antallet af vedhæftede beskeder til MMS'en. Hver værdi, er en URL hvor filen kan hentes fra. En af de vedhæftede filer kan være en SMIL fil, der indeholder et XML dokument der beskriver hvordan MMS'en skal vises.

Kunden ønsker at modtage beskeder på http://server.domain.tld:8080/receive.php.
En besked er modtaget fra +4512345678 på applikationskoden 1272 og med teksten hello world.

Forespørgslen vil se således ud:

For at sikre et retursvar til slutbrugeren, kan kunden øjeblikkeligt returnere et XML dokument.

XML dokumentet skal have rod tagget "reply".

I XML roden skal der være defineret tagget "message".

Følgende parametre kan benyttes:

price	Ønskes der overtaksering - værdien på takseringen angives i Øre.
statusurl	URL'en hvis der ønskes at modtage status rapporter. (Valgfri)
returndata	En streng på 255 octets, som kunden kan bruge som deres eget ID. (Valgfri)

Nedenstående eksempel takserer slutbrugeren med prisen "50 Øre", og sender teksten "Tak for din besked".

Ønskes der ikke et retur svar til brugeren, skal der svares med et tomt dokument, når vi kalder jeres server.