Add list of textbelt clients

This commit is contained in:
Ian Webster 2015-09-06 08:41:57 -07:00
parent b9fb645bac
commit 222562eca5

View File

@ -27,6 +27,7 @@ Sample failure:
``` ```
{"success":false,"message":"Exceeded quota for this phone number."} {"success":false,"message":"Exceeded quota for this phone number."}
``` ```
### Usage as a module ### Usage as a module
Though this repository contains an express server so you may run your own Though this repository contains an express server so you may run your own
@ -34,6 +35,7 @@ instance of the web app, you may also use it to send text messages in your
project. The only requirement is unix/posix `sendmail`, used to forward the message. project. The only requirement is unix/posix `sendmail`, used to forward the message.
For example, to send a text using the default settings: For example, to send a text using the default settings:
``` ```
var text = require('textbelt'); var text = require('textbelt');
@ -45,6 +47,7 @@ text.send('9491234567', 'A sample text message!', undefined, function(err) {
``` ```
You can also supply a region (valid choices are `us`, `intl`, or `canada`) You can also supply a region (valid choices are `us`, `intl`, or `canada`)
``` ```
var text = require('textbelt'); var text = require('textbelt');
@ -57,7 +60,6 @@ text.send('9491234567', 'A sample text message!', 'canada', function(err) {
text.send('1119491234567', 'Bonjour!', 'intl', function(err) { text.send('1119491234567', 'Bonjour!', 'intl', function(err) {
... ...
}); });
``` ```
### Usage as a standalone server ### Usage as a standalone server
@ -66,6 +68,8 @@ Textbelt can be run as a standalone server with: `node server/app.js`. Be sure
By default, the server listens on port 9090 and is configured to accept traffic from a reverse proxy or load balancer such as nginx. To enable accurate IP rate limiting, the reverse proxy should be configured to set the `X-Real-IP` header. By default, the server listens on port 9090 and is configured to accept traffic from a reverse proxy or load balancer such as nginx. To enable accurate IP rate limiting, the reverse proxy should be configured to set the `X-Real-IP` header.
Don't forget to set `fromAddress` in `lib/text.js` to the email address you want to send from.
### Canadian and International endpoints ### Canadian and International endpoints
The /text endpoint supports U.S. phone numbers (and parts of Canada). The /text endpoint supports U.S. phone numbers (and parts of Canada).
@ -76,6 +80,22 @@ For international texts, curl `http://textbelt.com/intl`.
Canadian and international support may not be complete. Refer to the list of supported carriers. Canadian and international support may not be complete. Refer to the list of supported carriers.
### Textbelt Clients
go - [dietsche/textbelt](https://github.com/dietsche/textbelt)
node.js - [minond/textbelt](https://github.com/minond/textbelt), [ajay-gandhi/textbelt](https://github.com/ajay-gandhi/textbelt), [soondobu/mtextbelt](https://github.com/soondobu/mtextbelt)
php - [ctrlaltdylan/courier](https://github.com/ctrlaltdylan/courier), [securingsincity/phpsms](https://github.com/securingsincity/phpsms)
bash - [cfalk/MessageMe](https://github.com/cfalk/MessageMe)
html/js webpage - [mLuby/SMS](https://github.com/mLuby/SMS)
Browser extension - [Chrome](https://chrome.google.com/webstore/detail/textbelter/clciehobfheendclpnmbgbalelignpoa), [Firefox](https://addons.mozilla.org/en-US/firefox/addon/textbelter/), [Safari](https://github.com/daluu/textbelt-clients/raw/master/textbelter.safariextz), [Opera](https://addons.opera.com/en/extensions/details/textbelter/?display=en)
Windows Phone - [TextBelter](https://www.microsoft.com/en-us/store/apps/textbelter/9nblggh1z2dg)
[SendSMS Mac App](https://itunes.apple.com/app/sendsms/id584131262?mt=12)
[OSX dashboard widget](https://github.com/daluu/textbelt-clients/releases/download/1.0/TextBelter.wdgt.zip)
[Windows 7/Vista gadget](https://github.com/daluu/textbelt-clients/releases/download/1.0/textbelter.gadget.zip)
### Notes and Limitations ### Notes and Limitations
* Some carriers are picky about which messages they deliver. A "success" response from Textbelt means that your message was given to the carrier. * Some carriers are picky about which messages they deliver. A "success" response from Textbelt means that your message was given to the carrier.