Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/AdmitHub/carrier-gateways

Translate cell phone numbers and carriers into SMS gateway email addresses
https://github.com/AdmitHub/carrier-gateways

Last synced: 4 months ago
JSON representation

Translate cell phone numbers and carriers into SMS gateway email addresses

Awesome Lists containing this project

README

        

Carrier Gateways
================

A simple package to translate cell phone numbers and carriers into SMS gateway
email addresses. Useful for sending notifications via SMS without having to
have SMS infrastructure.

Currently, the list is very US-centric, but PR's with other country's gateways
would be very welcome.

Installation
------------

Via npm:

npm install carrier-gateways

Usage
-----

- ``carrierGateways.getAddress(number, carrierName, [mms])`` - return the
email address for the given number and carrier.

``number`` must be a 10-digit (US) phone number. All non-numeric digits,
and a leading US country-code is stripped out.

``carrierName`` should be a name as listed in ``carrier-addresses.json``.

``mms`` - if truthy, and the carrier has a separate address for mms
messages, use that address instead.

Example:

var carrierGateways = require("carrier-gateways");

// Look up an address.
carrierGateways.getAddress("801-234-5678", "Verizon");
// returns [email protected]