Mediaburst Clockwork API wrapper
npm install clockwork
var clockwork = require'clockwork'key:'your clockwork key here';// Send a messageclockworksendSms To: '447123456789' Content: 'Test!'if errorconsole.log'Something went wrong' error;elseconsole.log'Message sent to'respresponses0to;console.log'MessageID was'respresponses0id;;
First, head over to clockwork and signup if you're not already signed up. Once signed up, log in to your clockwork account and add a new API Key (from the top menu choose Sending -> API Keys).
You can send a single message as shown above. If you have multiple messages to send, it's much more efficient to send them in bulk by passing an array of messages to
clockworksendSms To: '447123456789' Content: 'Test!'To: '447123456781' Content: 'Another one'if errorconsole.log'Something went wrong' error;elseconsole.log'Messages sent';;
The second argument to sendSms is callback that you provide. The callback will be called with 2 json objects,
response. If a general error occurs, then error will look like this:
success: falseerrNo: XerrDesc: 'Error description here'
Otherwise, error will be null, and the response will contain an array of sms responses, one for each message sent. In the example above where 2 messages were sent, assuming nothing went wrong, the response will look like this:
responses:to: '447123456789' success: true id: 'MessageId' errNo: '' ErrDesc: ''to: '447123456781' success: true id: 'MessageId' errNo: '' ErrDesc: ''
Currently, the nodejs wrapper only supports setting the to, from and content of sms messages. If you need to set other options, raise an issue in github and we'll try to get it done for you. For more information about sending messages and the responses, see the clockwork sms api documentation
clockworkgetBalanceif errorconsole.log'Something went wrong' error;elseconsole.log'Your balance'credit;;
Again, if a general error occurs then error will be populated accordingly. Otherwise, the response contains your credit, in a format similar to this:
accountType: 'PAYG'currency: code: 'USD' symbol: '$'balance: '100.0'