Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A node.js module to send SMS text messages through aspsms.com
branch: master
Failed to load latest commit information.
lib
.npmignore Added npm package description file and such
LICENSE
README.md Markdown error
package.json License and keywords fix

README.md

node-aspsms

A partial implementation of the aspsms.com XML SMS API for node.js.

Installation

sudo npm install aspsms

Methods

  • setDefaultOptions(options) Sets the default options
  • send(options, callback, message) Sends a text message
  • showCredits(options, callback, message) Returns the amount of credits left

Options

  • userkey Your ASPSMS Uesrkey
  • password Your ASPSMS password
  • originator Name of the sender
  • recipient Mobile phone number of the recipient

Errors

If the operation was successfull the error object passed to the callback will be null. If the operation fails the error object will contain an errorCode and an errorDescription field with values according to the aspsms.com documentation.

Examples

Send a text message

var aspsms = require('aspsms');

aspsms.setDefaultOptions({
    'userkey' : 'YOUR_ASPSMS_USERKEY', 
    'password' : 'YOUR_ASPSMS_PASSWORD', 
    'originator' : 'TestApp'
});

aspsms.send({
    'recipient' : '+41555123456'

}, function (error) {
    if (!error) {
        console.log('Success!');
    }

}, 'Hello, this is a test.');

Show how many credits you have left

var aspsms = require('aspsms');

aspsms.setDefaultOptions({
    'userkey' : 'YOUR_ASPSMS_USERKEY', 
    'password' : 'YOUR_ASPSMS_PASSWORD', 
});

aspsms.showCredits({ }, function (error, credits) {
    if (!error) {
        console.log('You have ' + credits + ' left');
    }

});

If you don't want to use setDefaultOptions you can pass all options in each command.

var aspsms = require('aspsms');

aspsms.send({
    'userkey' : 'YOUR_ASPSMS_USERKEY', 
    'password' : 'YOUR_ASPSMS_PASSWORD', 
    'originator' : 'TestApp', 
    'recipient' : '+41555123456'

}, function (error) {
    if (!error) {
        console.log('Success!');
    }

}, 'Hello, this is a test.');
Something went wrong with that request. Please try again.