Provisioning SMS and MMSC User Accounts via HTTP

Posted by on Feb 27, 2006 in Support Blog

Topic Keywords: ,

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=####

For comments and further discussion, please click here to visit the NowSMS Technical Forums (Discussion Board)...

One Response to “Provisioning SMS and MMSC User Accounts via HTTP”

  1. Recent versions of NowSMS have added additional SMS user account attributes, including whether or not the account can receive messages.

    For additional information on these attributes, please see the discussion at http://www.nowsms.com/discus/messages/1/70569.html