Home | Downloads | Support | Newsletter | Documentation | Related Links
 
Home
Downloads
Support
Documentation
Related Links
Provisioning SMS and MMSC User Accounts via HTTP
Document ID: TB-NOWSMS-013, Last Update: February 27, 2006

For NowSMS v5.51 and later, an HTTP-based interface has been added to allow for account provisioning by external applications. This interface is enabled when the web-based administration interface is enabled by checking "Enable Web Account Administration" on the "Web" page of the NowSMS configuration dialog.

This interface is accessed via the NowSMS web interface port, with a URI of "/provision" followed by a series of "HTTP GET" parameters. (The admin username and password must be supplied in the HTTP GET request within an "Authorization:" header using HTTP Basic Authentication.)

Two different provisioning request formats are defined, one for defining "SMS Users" accounts, and a second for defining "MMSC Users" accounts.

If a parameter of "Type=SMS" is specified, the following parameters are supported:

AdminAction=Add, Modify, Delete, or CreditCheck
Name=Account Name
Password=password
Fullname=Full Name
EnableWebLogin=Yes/No
EnableSmppLogin=Yes/No
EnableSmtpLogin=Yes/No
ForcedSenderAddress=Sender Address
RestrictIPAddress=list of IP addresses
EnableCreditBalance=Yes/No
CreditsToAdd=####
MessageLimitDefault=Yes/No
MessageLimitPerDay=####
MessageLimitPerMonth=####
RecipientAddresses=list of recipient phone numbers that should be routed to this account

As an example, to add credits to an existing account, issue the following URL request:

http://server:port/provision?Type=SMS&AdminAction=Modify&Name=accountname&CreditsToAdd=100

Assuming that the user is authorized to issue a provisioning command (valid username/password, and supported IP address for originating the request), the server will return a normal HTTP response code of 200 with a MIME content type of "text/plain". The response will start with "OK" if the request was successful, or "ERROR" if the request failed. If a "CreditsToAdd" parameter was specified, or "AdminAction=CreditCheck", the HTTP response will include the text "Credits=####", where "####" is the current balance for the account.

If a parameter of "Type=MMS" is specified, the following parameters are supported:

AdminAction=Add, Modify, Delete, or CreditCheck
PhoneNumber=phonenumber
Name=Alias
Password=password
Fullname=Full Name
MessageLimitDefault=Yes/No
MessageLimitPerDay=####
MessageLimitPerMonth=####

Return to Now SMS/MMS Gateway Technical Bulletins