TELUS APIs

Available APIs and Services

1. Mobile Connect
2. Get Terminal Location Service
3. Send SMS Service

Mobile Connect

Mobile Connect is a global standard for federated authentication. The idea is that you would use the Mobile Connect app on your phone to log into various websites and applications, rather than having a separate username and password for each site that you use. This is similar to using your Google or Facebook account to log into sites like Pinterest and Goodreads.

First, you install Mobile connect on your phone and enroll yourself to use the service. You will be asked for your carrier billing information, which will be confirmed by your carrier to ensure your identity. You can then set a pin or fingerprint as your way to authenticate in the Mobile Connect app (so that your account is secure even in the event of a lost or stolen phone).

Next, when you visit a Mobile Connect enabled site on your laptop (or on any device), you can click the Mobile Connect button to log in rather than using a username and password. You enter your phone number and then you will receive a notification on your phone prompting you to authenticate in the Mobile Connect App. When you complete authentication in the app, you will be logged into the site on your laptop.

No more remembering usernames and passwords: all authentication can be managed in one place through the Mobile Connect app. Add Mobile Connect authentication to your site or app to enable your users to use their phone as their login credentials.

Get Terminal Location Service

The Terminal Location API allows you to look up the location of a cell phone by its phone number in your application. This works only for TELUS phone numbers, and the user of the phone must have authorized your application to perform this query. You will get a set of credentials for your application, and then you must add numbers that you own to the whitelist of numbers that your application is allowed to query.

You can use this service by sending a SOAP request with the following format:

 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:loc="http://www.csapi.org/schema/parlayx/terminal_location/v2_3/local">

    <soapenv:Header/>

    <soapenv:Body>

       <loc:getLocation>

          <loc:address>tel:16042917290</loc:address>

          <loc:requestedAccuracy>5000</loc:requestedAccuracy>

          <loc:acceptableAccuracy>5000</loc:acceptableAccuracy>

       </loc:getLocation>

    </soapenv:Body>

 </soapenv:Envelope> 

loc:address -  The telephone number to find the location of

loc:requestedAccuracy -  The accuracy you would like on that location in meters

loc:acceptableAccuracy -  Location accuracy must be within this number of meters

Depending on the accuracy that you specify, different technologies will be used. Lower accuracy will take less time to ascertain.

We suggest using an accuracy level of 5000m or greater in order to get fast responses.

The response you receive will look something like this:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

    <soap:Body>

       <ns2:getLocationResponse xmlns:ns2="http://www.csapi.org/schema/parlayx/terminal_location/v2_3/local" xmlns:ns3="http://www.csapi.org/schema/parlayx/common/v2_1">

          <ns2:result>

             <latitude>49.267</latitude>

             <longitude>-123.0068</longitude>

             <altitude>22.0</altitude>

             <accuracy>182</accuracy>

             <timestamp>2008-07-10T12:54:40.000-04:00</timestamp>

          </ns2:result>

       </ns2:getLocationResponse>

    </soap:Body>

 </soap:Envelope> 

 latitude, longitude: Coordinates where the subscriber is located

altitude: The subscribers elevation

accuracy: how accurate the location result is in meters

timestamp: the time at which the subscribers location was found

Send SMS Service

The SMS API allows you to send SMS messages through your application.