Académique Documents
Professionnel Documents
Culture Documents
Version 2.0
Table of Content
1.
Introduction............................................................................................................... 3
2.
www.mnatives.com
1. Introduction
This document outlines the specification of mNatives with respect to PUSH messaging
system. The target audience of this document is internal customers, stakeholders, mNatives
existing and potential Customers.
2.1
Users can push message through URL using GET method. Choosing GET as the "method"
will append all of the data to the URL; hence it is restricted to only 1024 characters.
www.mnatives.com
Parameter Parameter
Name
Description
Parameter Value
Parameter Type
userid
Account User Id
pwd
Account password
Password provided
ctype
Content Type
sender
Account Sender
pno
msgtxt
Message to be send
Test msg
msgid
Message Id
alert
For pushing
promotional or Alert
messages
www.mnatives.com
msgtype
Message Type
S=SMS
siurl
* M=Mandatory, O=Optional
www.mnatives.com
2.2
Users can push message through xml using post method. Choosing POST as the "method",
the connection to the URL will be opened and XML chunk will be posted on the connection.
There is no restriction of the character length and is secure method.
<?xml version=1.0?>
<push>
<userid>xxxx</userid>
<pwd>xxxx</pwd>
<ctype>xxx</ctype>
<sender>xxxx</sender>"
<multisms>
<detail msgid='xxx' msgtxt=xxxxxxx siurl='NA'>
<to id='xxxxx' pno='xxxxx' />
<to id='xxx' pno='xxxxxx' />
</detail>
</multisms>
<dlr>xxx</dlr>
<alert>xxx</alert>
</push>
Parameter Name
Parameter Description
Parameter Value
Parameter Type
userid
Account User Id
pwd
Account password
Password provided
www.mnatives.com
ctype
Content Type
sender
Account Sender
Approved Sender
Name
id
msgid
Message Id
siurl
www.mnatives.com
NA
alert
pno
919810790590
dlr
1 (For receiving a
delivery report)
Test msg
msgtxt
Message to be send
0 (For Promotional
messages)
* M=Mandatory, O=Optional
2.2.3 Sample
package com.aclwireless.getbroadcast.test;
import java.net.URL;
import java.net.URLConnection;
import java.io.OutputStream;
import java.io.InputStream;
www.mnatives.com
2.3
http://203.122.58.168:8000/servlet/com.aclwireless.enterprise.prepaidcbs.listeners.GetCredits?use
rid=userid&pwd=password
For every successful submission to mNative platform, platform returns the number of
available credits.
Format: 1001 (i.e. available credits information)
2.4
http://203.122.58.168:8060/servlet/com.aclwireless.enterprise.prepaiddlr.listeners.GetInfo?userid=
userid&password=password&msisdn=919810790590&appresponse=response id&date=20100829
* appresponse = Response id which has been retrieved at time of push message.
* date = Date on which the message is pushed in (yyyymmdd) format
For every successful submission to mNative platform, platform returns the delivery Status.
Format: Delivered (the status is displayed depending on the status received from the
platform)
2.5
www.mnatives.com
2.6
Error codes
In case of failure, mNative will not return response id but return the error code.
Error Codes
-1
-2
-3
-4
-5
-6
-7
-8
-9
-10
-11
-12
-13
-14
-15
-16
-17
-18
-19
-20
-21
-22
-100
-101
-102
-103
-104
-105
-333
Error Description
RESERVED
MISSING USERID
MISSING PASSWORD
MISSING CONTENTID
MISSING SENDER
MISSING MOBILENUMBER
MISSING MESSAGETEXT
RESERVED
MISSING SIURL
AUTHENTICATION FAILED
RESERVED
MESSAGEID REPETED
CONTENT NOT ALLOWDED
RESERVED
MALFORMED XML DATA RECEIVED
INVALID DNDFLAG VALUE
RESERVED
INVALID CLI
RESERVED
RESERVED
MOBILE NUMBER IN DND
RESERVED
CREDIT NOT AVAILABLE
CREDIT NOT SUFFICIENT
RESERVED
RESERVED
APP INTERNAL ERROR
PRICE NOT FOUND
PARAMETER MISSING (for credit availability &
message Status enquiry)
www.mnatives.com