The document provides an overview of the Carma APIs which allow access to all the features of the Carma ridesharing app. It describes prizes for developers who verify trips using the APIs, lists the API endpoints and authentication methods, and provides example API calls for user registration, finding nearby drivers and riders, booking trips, and rating drivers. It encourages attendees to try out the development APIs and get help from Carma representatives with any issues.

1. The Carma APIs
Smart transportation & energy hackathon
June 14th, 2014

2. Overview
• Quick reminder about Carma from yesterday
evening
• Description of APIs and server environments
• A few example API calls
• Hands-on hacking

3. The Carma Prize
• $ 1 million to external developer team that verifies 10,000 daily trips
• $1 million to Carma employee who verifies 1,000 daily trips
• $500,000 to start-ups to take on the challenge
• https://carmacarpool.com/prize/

4. The APIs
• Provide access to everything that the Carma app can do
• User registration
• User discovery
• User-to-user messaging
• Bookings
• Picking up and dropping off a user (inc. credits transfer)
• Lots more!

5. Getting access
• OAuth client details
• Options:
• Signup on api.car.ma
• Send an email to carma-apis@car.ma
• 2 scopes, standard and account reg
• 3 diff flows: auth code, implicit, password

6. Development server
• Provides access to APIs, intended for development
• OAuth client for testing
• client_id: example-client
• client_secret: example
• https://api-dev.car.ma
• https://rtr-dev.car.ma/rtr-desktop-web
• https://rtr-dev.car.ma/rtr-mobile-web
• Carma App for dev env coming next week

7. Production
• OAuth client details required
• for access (talk to us)
• https://api.car.ma
• https://api.carmacarpool.com

8. Example API calls
http://pastebin.com/0aP3XkLT
• 0.1. create account A (driver)
• 0.2. create account B (rider)
• 1.1 post location as driver
• 1.2 find nearby users as rider
• 1.3 join driver car by id as rider
• (leave driver do the driving!)
• 1.4 dropoff as rider
• 1.5 rate driver
• 1.6 check profile of driver

9. Hands-on hacking
• Create a user account (or several)
• Log in to get an OAuth token
• Pair up with a neighbour - take a trip
!
• We’ll be on hand to help with anything
• Talk to us if you’d like custom dev OAuth client details
• carma-apis@car.ma