Skip to content

venkatesh3007/node-uber

BranchesTags
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

113 Commits
examples
examples
 
 
lib
lib
 
 
test
test
 
 
.codeclimate.yml
.codeclimate.yml
 
 
.eslintignore
.eslintignore
 
 
.eslintrc
.eslintrc
 
 
.gitignore
.gitignore
 
 
.publishrc
.publishrc
 
 
.travis.yml
.travis.yml
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
gulpfile.js
gulpfile.js
 
 
index.js
index.js
 
 
package.json
package.json
 
 

Repository files navigation

Join the chat at https://gitter.im/shernshiou/node-uber License build status Dependency Status devDependency Status Code Climate Test Coverage

Uber Rides Node.js Wrapper

This projects helps you to make HTTP requests to the Uber Rides API.

Installation

Before you begin, you need to register your app in the Uber developer dashboard. Notice that the app gets a client ID, secret, and server token required for authenticating with the API.

After registering your application, you need to install this module in your Node.js project:

npm install node-uber

Initialization

In order to use this module, you have to import it in your application first:

var Uber = require('node-uber');

Next, initialize the Uber object with the keys you obtained from the Uber developer dashboard:

var uber = new Uber({
  client_id: 'CLIENT_ID',
  client_secret: 'CLIENT_SECRET',
  server_token: 'SERVER_TOKEN',
  redirect_uri: 'REDIRECT URL',
  name: 'APP_NAME',
  language: 'en_US', // optional, defaults to en_US
  sandbox: true // optional, defaults to false
});

Note: For all available language options check out the Localization page of the API.

Authenticating

To make HTTP calls, you need to create an authenticated session with the API. User-specific operations require you to use a OAuth 2 bearer token with specific scopes. Jump to the method overview section to identify required scopes for methods. General operations can use a simple server-token authentication.

Step one: Authorize

To obtain an OAuth 2 bearer token, you have to authorize your application with the required scope. Available scopes are: history, history_lite, profile, request, all_trips, and places.

To do so, you are initially required to redirect your user to an authorization URL. You can generate the authorization URL using uber.getAuthorizeUrl. In case you are using Express, your route definition could look as follows:

app.get('/api/login', function(request, response) {
  var url = uber.getAuthorizeUrl(['history','profile', 'request', 'places']);
  response.redirect(url);
});

The URL will lead to a page where your user will be required to login and approve access to his/her Uber account. In case that step was successful, Uber will issue an HTTP 302 redirect to the redirect_uri defined in the Uber developer dashboard. On that redirect, you will receive an authorization code, which is single use and expires in 10 minutes.

Step two: Receive redirect and get an access token

To complete the authorization you now need to receive the callback and convert the given authorization code into an OAuth access token. You can accomplish that using uber.authorization. This method will retrieve and store the access token within the uber object for consecutive requests.

Using Express, you could achieve that as follows:

app.get('/api/callback', function(request, response) {
   uber.authorization({
     authorization_code: request.query.code
   }, function(err, access_token, refresh_token) {
     if (err) {
       console.error(err);
     } else {
       // store the user id and associated access token
       // redirect the user back to your actual app
       response.redirect('/web/index.html');
     }
   });
});

Step three: Make HTTP requests to available resources

Now that you are authenticated, you can issue requests using provided methods.

For instance, to obtain a list of available Uber products for a specific location, you can use uber.products.getAllForLocation.

In case you are using Express, your route definition could look as follows:

app.get('/api/products', function(request, response) {
  // extract the query from the request URL
  var query = url.parse(request.url, true).query;

  // if no query params sent, respond with Bad Request
  if (!query || !query.lat || !query.lng) {
    response.sendStatus(400);
  } else {
    uber.products.getAllForLocation(query.lat, query.lng, function(err, res) {
      if (err) {
        console.error(err);
        response.sendStatus(500);
      } else {
        response.json(res);
      }
    });
  }
});

Method Overview

HTTP Method Endpoint Auth Method Required Scope Methods
GET /v1/products OAuth or server_token products.getAllForLocation
GET /v1/products/{product_id} OAuth or server_token products.getByID
PUT /v1/sandbox/products/{product_id} OAuth or server_token (Sandbox mode) products.setSurgeMultiplierByID
PUT /v1/sandbox/products/{product_id} OAuth or server_token (Sandbox mode) products.setDriversAvailabilityByID
GET /v1/estimates/price OAuth or server_token estimates.getPriceForRoute
GET /v1/estimates/time OAuth or server_token estimates.getETAForLocation
GET /v1.2/history OAuth history or history_lite user.getHistory
GET /v1/me OAuth profile user.getProfile
POST /v1/requests OAuth request (privileged) requests.create
GET /v1/requests/current OAuth request (privileged) or all_trips (privileged) requests.getCurrent
PATCH /v1/requests/current OAuth request (privileged) requests.updateCurrent
DELETE /v1/requests/current OAuth request (privileged) requests.deleteCurrent
POST /v1/requests/estimate OAuth request (privileged) requests.getEstimates
GET /v1/requests/{request_id} OAuth request (privileged) requests.getByID
PATCH /v1/requests/{request_id} OAuth request (privileged) requests.updateByID
PUT /v1/sandbox/requests/{request_id} OAuth request (privileged & Sandbox mode ) requests.setStatusByID
DELETE /v1/requests/{request_id} OAuth request (privileged) requests.deleteByID
GET /v1/requests/{request_id}/map OAuth request (privileged) requests.getMapByID
GET /v1/requests/{request_id}/receipt OAuth request_receipt (privileged) requests.getReceiptByID
GET /v1/places/{place_id} OAuth places places.getHome and places.getWork
PUT /v1/places/{place_id} OAuth places places.updateHome and places.updateWork
GET v1/payment-methods OAuth request (privileged) payment.getMethods
POST /v1/reminders server_token reminders.create
GET /v1/reminders/{reminder_id} server_token reminders.getByID
PATCH /v1/reminders/{reminder_id} server_token reminders.updateByID
DELETE /v1/reminders/{reminder_id} server_token reminders.deleteByID

Endpoint Details

Authorization (OAuth 2.0)

Generate Authorize URL

After getting the authorize url, the user will be redirected to the redirect url with authorization code used in the next function.

uber.getAuthorizeUrl(parameter);
Parameter
  • Array of scopes
Example
uber.getAuthorizeUrl(['history','profile', 'request', 'places']);

Authorize

Used to convert authorization code or refresh token into access token.

uber.authorization(parameter, callback);
Parameter
  • JS Object with attribute authorization_code OR refresh_token
Example
uber.authorization({ refresh_token: 'REFRESH_TOKEN' },
  function (err, access_token, refresh_token) {
    if (err) console.error(err);
    else {
      console.log(access_token);
      console.log(refresh_token);
    }
  });

/products

The product endpoint can be accessed either with an OAuth access_token or simply with the server_token because it is not user-specific. It has, therefore, no required scope for access.

Get available products for location

uber.products.getAllForLocation(latitude, longitude, callback);
Example
uber.products.getAllForLocation(3.1357, 101.6880, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Get product details by product_id

uber.products.getByID(product_id, callback);
Example
uber.products.getByID('d4abaae7-f4d6-4152-91cc-77523e8165a4', function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Set driver's availability by product_id

uber.products.setDriversAvailabilityByID(product_id, availability, callback);

Note: This method is only allowed in Sandbox mode.

Parameter
  • availability (boolean) will force requests to return a no_drivers_available error if set to false
Example
uber.products.setDriversAvailabilityByID('d4abaae7-f4d6-4152-91cc-77523e8165a4', false, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Set surge multiplier by product_id

uber.products.setSurgeMultiplierByID(product_id, multiplier, callback);

Note: This method is only allowed in Sandbox mode.

Parameter
  • multiplier (float) will force two stage confirmation for requests if > 2.0
Example
uber.products.setSurgeMultiplierByID('d4abaae7-f4d6-4152-91cc-77523e8165a4', 2.2, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

/estimates

The estimates endpoint can be accessed either with an OAuth access_token or simply with the server_token because it is not user-specific. It has, therefore, no required scope for access.

Get price estimates for specific route

uber.estimates.getPriceForRoute(start_latitude, start_longitude, end_latitude, end_longitude [, seats], callback);

seats defaults to 2, which is also the maximum value for this parameter.

Example
uber.estimates.getPriceForRoute(3.1357, 101.6880, 3.0833, 101.6500, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Get ETA for location

uber.estimates.getETAForLocation(latitude, longitude [, product_id], callback);
Example
uber.estimates.getETAForLocation(3.1357, 101.6880, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

/history

The history endpoint can be accessed ONLY with an OAuth access_token authorized with either the history or history_lite (without city information) scope.

Get user activity

uber.user.getHistory(offset, limit, callback);

offset defaults to 0 and limit defaults to 5 with a maximum value of 50.

Example
uber.user.getHistory(0, 5, function(err, res) {
  if (err) console.log(err);
  else console.log(res);
});

/me

The me endpoint can be accessed ONLY with an OAuth access_token authorized with the profile scope.

Get user profile

uber.user.getProfile(callback);
Example
uber.user.getProfile(function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

/requests

The requests endpoint can be accessed ONLY with an OAuth access_token authorized with the request scope.

Create new request

uber.requests.create(parameter, callback);
Parameter
  • JS Object with at least the following attributes: start_latitude & start_longitude OR start_place_id
Example
uber.requests.create({
  "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
  "start_latitude": 37.761492,
  "start_longitude": -122.423941,
  "end_latitude": 37.775393,
  "end_longitude": -122.417546
}, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Get current request

Note: By default, only details about trips your app requested will be returned. This endpoint can be used with the scope all_trips to get all trips irrespective of which application initiated them.

uber.requests.getCurrent(callback);
Example
uber.requests.getCurrent(function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Update current request

uber.requests.updateCurrent(parameter, callback);
Parameter
  • JS Object with attributes to be updated (only destination-related attributes enabled)
Example
uber.requests.updateCurrent({
  "end_latitude": 37.775393,
  "end_longitude": -122.417546
}, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Delete current request

uber.requests.deleteCurrent(callback);
Example
uber.requests.deleteCurrent(function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Get estimates

uber.requests.getEstimates(parameter, callback);
Parameter
  • JS Object with at least the following attributes: start_latitude & start_longitude OR start_place_id
Example
uber.requests.getEstimates({
  "product_id": "a1111c8c-c720-46c3-8534-2fcdd730040d",
  "start_latitude": 37.761492,
  "start_longitude": -122.423941,
  "end_latitude": 37.775393,
  "end_longitude": -122.417546
}, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Get request by request_id

uber.requests.getByID(request_id, callback);
Example
uber.requests.getByID('17cb78a7-b672-4d34-a288-a6c6e44d5315', function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Update request by request_id

uber.requests.updateByID(request_id, parameter, callback);
Parameter
  • JS Object with attributes to be updated (only destination-related attributes enabled)
Example
uber.requests.updateByID('17cb78a7-b672-4d34-a288-a6c6e44d5315', {
  "end_latitude": 37.775393,
  "end_longitude": -122.417546
}, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Set request status by request_id

uber.requests.setStatusByID(request_id, status, callback);

Note: This method is only allowed in Sandbox mode. Check out the documentation for valid status properties.

Example
uber.requests.setStatusByID('17cb78a7-b672-4d34-a288-a6c6e44d5315', 'accepted', function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Delete request by request_id

uber.requests.deleteByID(request_id, callback);
Example
uber.requests.deleteByID('17cb78a7-b672-4d34-a288-a6c6e44d5315', function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Get request map by request_id

uber.requests.getMapByID(request_id, callback);

Unless the referenced request is in status accepted, a 404 error will be returned.

Example
uber.requests.getMapByID('17cb78a7-b672-4d34-a288-a6c6e44d5315', function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Get request receipt by request_id

Note: This endpoint requires OAuth authentication with the scope request_receipt

uber.requests.getReceiptByID(request_id, callback);

The referenced request must be in status completed.

Example
uber.requests.getReceiptByID('17cb78a7-b672-4d34-a288-a6c6e44d5315', function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

/places

The places endpoint can be accessed ONLY with an OAuth access_token authorized with the places scope.

Note: As of right now, only two place_ids are allowed: home and work.

Get home address

uber.places.getHome(callback);
Example
uber.places.getHome(function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Get work address

uber.places.getWork(callback);
Example
uber.places.getWork(function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Update home address

uber.places.updateHome(address, callback);
Example
uber.places.updateHome('685 Market St, San Francisco, CA 94103, USA', function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Update work address

uber.places.updateWork(address, callback);
Example
uber.places.updateWork('1455 Market St, San Francisco, CA 94103, USA', function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

/payment-methods

The payment-methods endpoint can be accessed ONLY with an OAuth access_token authorized with the request scope.

Get available payment methods

uber.payment.getMethods(callback);
Example
uber.payment.getMethods(function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

/reminders

The reminders endpoint can be accessed ONLY with a server_token. No OAuth authorization is needed.

Create new reminder

uber.reminders.create(parameter, callback);
Parameter
  • JS Object with at least the following attributes: reminder_time, phone_number, event & event.time
Example
uber.reminders.create({
  reminder_time: 1429294463,
  phone_number: '+10000000000',
  event: {
    time: 1429294463,
    name: 'Frisbee with friends',
    location: 'Dolores Park',
    latitude: 37.759773,
    longitude: -122.427063,
    product_id: 'a1111c8c-c720-46c3-8534-2fcdd730040d'
  }
}, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Get reminder by reminder_id

uber.reminders.getByID(reminder_id, callback);
Example
uber.reminders.getByID('def-456', function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Update reminder by reminder_id

uber.reminders.updateByID(reminder_id, parameter, callback);
Parameter
  • JS Object with attributes to be updated
Example
uber.reminders.updateByID('def-456', {
  event: {
    time: 1429294463,
    name: 'Frisbee with friends',
    location: 'Dolores Park',
    latitude: 37.759773,
    longitude: -122.427063,
    product_id: 'a1111c8c-c720-46c3-8534-2fcdd730040d'
  }
}, function (err, res) {
  if (err) console.error(err);
  else console.log(res);
});

Delete reminder by reminder_id

uber.reminders.deleteByID(reminder_id, callback);
Example
uber.reminders.deleteByID('def-456', function (err, res) {
  if (err) console.log(err);
  else console.log(res);
});

Test

You can execute all existing tests using script test/allTests.js. These tests include linting, code coverage, and unit tests.

npm test

In case you would like to contribute to this project, please ensure that all the tests pass before you create a PR. We have strict code style and code coverage (>= 95%) requirements.

Version History

The change-log can be found in the Wiki: Version History.

TODOs

  • Add node-geocoder to enable using street addresses
  • Test translation support using Content-Language
  • Promisify using bluebird
  • Implement rate limit status
  • Leverage Surge Pricing responses
  • Implement access_token refresh
  • Checks for scopes
  • Checks for auth methods
  • Leverage Webhooks
  • Learn from other Uber SDKs
  • Check UberPOOL compatibility (https://developer.uber.com/docs/tutorials-rides-api#section-uberpool)

About

Uber API nodejs wrapper

Resources

Readme

License

MIT license
Activity

Stars

0 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

7 tags

Packages

No packages published

Languages

  • JavaScript 100.0%