Lyft Driver 图标

Lyft Driver 司机端数据 API

Lyft, Inc. · 出行

Lyft Driver 是总部位于旧金山的网约车公司 Lyft, Inc. 推出的司机端应用,也是独立司机在 Lyft 平台上接单出车的工具。司机可用手机号、恢复码或通行密钥登录,绑定车辆后上线等待派单,并可通过末单与目的地筛选决定下一单驶向哪里。每条预付行程报价在接单前就会显示乘客名字与评分、下车目的地和预估收入区间;接单后按到达、接客、送达、取消与为乘客评分的流程推进,行程中面板会显示本趟路线的实得收入与小费。收入首页以周图表呈现总收入、净收入与小费,并附逐程收入列表,每周明细页可对比以往各个结算周期。提现面板支持在每日次数上限内用 Express Pay 即时提现,与每周自动银行打款并行,司机还能在同一处管理 Lyft Direct 借记卡账户。此外,司机可在每周计划与激励地图上挑选行程挑战和连单奖励,查看服务质量评分与乘客反馈记录,以及在结清前会暂停即时提现的未结欠款。该应用面向美国市场,是 Lyft 乘客端应用的工作端搭档,与 Uber 司机端争夺同一批零工司机。

预付行程报价是这份记录的起点:每条报价带有 offer_id、乘客的 passenger_rating、以 destination_lat/destination_lng 表示的下车点,以及从 min_estimated_earnings 到 max_estimated_earnings 的收入区间。接单后,同一组 ride_id 与 route_id 一直延续到送达后结算的行程收入 route_payout_total_amount 与 route_payout_tips_amount。

这些行程再汇总为周期内的 gross_earnings、net_earnings 与 tip_amount,以 payout_period_ms 为键、附带 weekly_payout 的逐周明细,以及逐程的 payout_total 收入流,金额均为带 currency 与 exponent 的美元最小单位数值。提现钱包补充了 available_balance、instant_payout_enabled、max_payouts_per_day 上限与 next_payout_timestamp;每笔 Express Pay 即时提现或每周银行打款都以 payout_transaction_id、payout_type、payout_time_ms 与 display_status 记录在案。debt_amount 与 outstanding_balance_amount 记录可能阻断即时提现的欠款,lyftDirectEnabled 及账户 status(Active、InReview、CardSuspended、AccountBlocked)则追踪 Lyft Direct 借记卡账户。

司机状态补全了这份记录:driver_id、driver_rating、overall_rating 与 qualifying_rating、current_deactivation_status 和当前绑定的 vehicle_id,以及按 estimated_earnings 定价的行程挑战与连单奖励。

零工金融与记账工具用钱包和提现记录,每晚把每笔 Express Pay 提现与司机台账逐一核对;收入与报税追踪工具依据周期汇总、逐周明细和逐程收入流,按单重建一整周的车费加小费收入;车队与租车合作方在把司机视为可派单之前,先读取停用状态、评分与绑定车辆;司机端收入工具则把每条预付报价给出的收入区间,与送达后路线实际支付的金额对照。openData Studio 将这份涵盖报价、行程、提现与司机状态的 Lyft 司机记录变为可调用的开放数据。

应用截图

  • Lyft Driver 应用截图 1
  • Lyft Driver 应用截图 2
  • Lyft Driver 应用截图 3
  • Lyft Driver 应用截图 4
  • Lyft Driver 应用截图 5
  • Lyft Driver 应用截图 6

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。

  • OAuth2 访问令牌

    POST /v1/auth/driver-session osint

    签发后续所有薪酬、收入、行程与提现调用所用的司机会话:access_token、refresh_token、token_type、expires_in 与 lyft_user_id。支持手机号、恢复码与通行密钥等授权类型。

    认证方式: 无(签发令牌)。后续调用发送 Authorization: Bearer access_token 并携带区域头。

    • grant_type
    • phone_number
    • client_id
    • access_token
    • refresh_token
    • token_type
    • expires_in
    • user_id
    • lyft_user_id
    POST /v1/auth/driver-session HTTP/1.1
    Content-Type: application/x-www-form-urlencoded
    
    grant_type=phone&phone_number=%2B14155550199&client_id=driver-app
    {
      "access_token": "eyJhbGciOi...",
      "refresh_token": "d8f1c2a9...",
      "token_type": "Bearer",
      "expires_in": 2592000,
      "user_id": "123456789",
      "lyft_user_id": "123456789"
    }
  • 司机资料

    GET /v1/partner/profile osint

    加载已登录司机的资料卡:driver_id、姓名、手机号、driver_rating、停用状态,以及首页地图与收入界面所依赖的当前绑定 vehicle_id。

    认证方式: 会话登录调用签发的 Bearer access token,外加区域头

    • driver_id
    • lyft_user_id
    • first_name
    • last_name
    • phone_number
    • driver_rating
    • overall_rating
    • current_deactivation_status
    • vehicle_id
    GET /v1/partner/profile HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "driver_id": "d_9b0e12f4",
      "lyft_user_id": "123456789",
      "first_name": "Alex",
      "last_name": "Rivera",
      "phone_number": "+14155550199",
      "driver_rating": 4.92,
      "overall_rating": 4.92,
      "current_deactivation_status": "NONE",
      "vehicle_id": "veh_7c81f0e2"
    }
  • 司机薪酬余额

    GET /v1/partner-wallet/balance openbanking

    读取收入栏背后的提现钱包:以 Money(amount、currency、exponent)表示的 available_balance、是否开启即时提现、每日提现上限与下次每周打款时间戳。

    认证方式: 会话登录调用签发的 Bearer access token

    • available_balance
    • availableBalance
    • amount
    • currency
    • exponent
    • instant_payout_enabled
    • max_payouts_per_day
    • next_payout_timestamp
    • lyftDirectEnabled
    GET /v1/partner-wallet/balance HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "available_balance": {
        "amount": 18450,
        "currency": "USD",
        "exponent": 2
      },
      "availableBalance": 184.50,
      "instant_payout_enabled": true,
      "max_payouts_per_day": 5,
      "next_payout_timestamp": 1759276800000,
      "lyftDirectEnabled": true
    }
  • 收入汇总

    GET /v1/earnings/overview openfinance

    返回收入首页展示的周期收入汇总:gross_earnings、net_earnings、tip_amount、estimated_earnings 与 ride_payout_total_amount,均为 Money 对象。

    认证方式: 会话登录调用签发的 Bearer access token

    • gross_earnings
    • net_earnings
    • tip_amount
    • estimated_earnings
    • ride_payout_total_amount
    • amount
    • currency
    • exponent
    GET /v1/earnings/overview HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "gross_earnings": {"amount": 94200, "currency": "USD", "exponent": 2},
      "net_earnings": {"amount": 78150, "currency": "USD", "exponent": 2},
      "tip_amount": {"amount": 6300, "currency": "USD", "exponent": 2},
      "estimated_earnings": {"amount": 12000, "currency": "USD", "exponent": 2},
      "ride_payout_total_amount": {"amount": 71850, "currency": "USD", "exponent": 2}
    }
  • 司机收入动态

    GET /v1/earnings/trip-feed openfinance

    分页返回收入界面的逐程动态流:每个已完成行程的 ride_id、route_id、gross_earnings、tip_amount 与 payout_total。

    认证方式: 会话登录调用签发的 Bearer access token

    • ride_id
    • route_id
    • gross_earnings
    • tip_amount
    • payout_total
    • payout_type
    GET /v1/earnings/trip-feed HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "sections": [
        {
          "ride_id": "rid_4e91aa12",
          "route_id": "rte_8c22b1d0",
          "gross_earnings": {"amount": 1850, "currency": "USD", "exponent": 2},
          "tip_amount": {"amount": 400, "currency": "USD", "exponent": 2},
          "payout_total": {"amount": 2250, "currency": "USD", "exponent": 2},
          "payout_type": "express_pay"
        }
      ]
    }
  • 收入仪表板历史

    GET /v1/earnings/dashboard openfinance

    加载收入仪表板的历史标签页:Balance(available_balance)、Stats(gross/net)与驱动每周图表和提现按钮的 Modules。

    认证方式: 会话登录调用签发的 Bearer access token

    • balance
    • available_balance
    • stats
    • gross_earnings
    • net_earnings
    • modules
    GET /v1/earnings/dashboard HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "balance": {
        "available_balance": {"amount": 18450, "currency": "USD", "exponent": 2}
      },
      "stats": {
        "gross_earnings": {"amount": 94200, "currency": "USD", "exponent": 2},
        "net_earnings": {"amount": 78150, "currency": "USD", "exponent": 2}
      },
      "modules": []
    }
  • 每周收入明细

    GET /v1/earnings/weekly openfinance

    返回逐周收入明细:每周明细入口背后的 payout_period_ms、gross/net、小费与 weekly_payout。

    认证方式: 会话登录调用签发的 Bearer access token

    • payout_period_ms
    • gross_earnings
    • net_earnings
    • tip_amount
    • weekly_payout
    GET /v1/earnings/weekly HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "stats": [
        {
          "payout_period_ms": 1758672000000,
          "gross_earnings": {"amount": 94200, "currency": "USD", "exponent": 2},
          "net_earnings": {"amount": 78150, "currency": "USD", "exponent": 2},
          "tip_amount": {"amount": 6300, "currency": "USD", "exponent": 2},
          "weekly_payout": {"amount": 78150, "currency": "USD", "exponent": 2}
        }
      ]
    }
  • 提现资格

    GET /v1/payouts/eligibility openbanking

    检查当前是否允许即时提现,并返回提现面板渲染所用的可提现 line_items、available_balance 与每日上限。

    认证方式: 会话登录调用签发的 Bearer access token

    • instant_payout_enabled
    • available_balance
    • max_payouts_per_day
    • line_items
    • payout_type
    • amount
    • currency
    GET /v1/payouts/eligibility HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "instant_payout_enabled": true,
      "available_balance": {"amount": 18450, "currency": "USD", "exponent": 2},
      "max_payouts_per_day": 5,
      "line_items": [
        {"amount": {"amount": 18450, "currency": "USD", "exponent": 2}, "payout_type": "express_pay"}
      ]
    }
  • Express Pay 即时提现

    POST /v1/payouts/instant openbanking

    对可提现的 available_balance 写入一笔即时提现,返回 payout_transaction_id、payout_type、payout_total 与 payout_time_ms。

    认证方式: 会话登录调用签发的 Bearer access token

    • amount
    • currency
    • exponent
    • payout_type
    • payout_transaction_id
    • payoutTransactionId
    • payoutType
    • payout_type_text
    • payout_total
    • payout_time_ms
    POST /v1/payouts/instant HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    Content-Type: application/json
    
    {
      "amount": {"amount": 18450, "currency": "USD", "exponent": 2},
      "payout_type": "express_pay"
    }
    {
      "payout_transaction_id": "po_6a11c4e8",
      "payoutTransactionId": "po_6a11c4e8",
      "payout_type": "express_pay",
      "payoutType": "express_pay",
      "payout_type_text": "Express Pay",
      "payout_total": {"amount": 18450, "currency": "USD", "exponent": 2},
      "payout_time_ms": 1759190400000
    }
  • 提现历史

    GET /v1/payouts/history openbanking

    以明细行记录列出历史即时提现与每周银行打款:payout_transaction_id、payout_type、payout_total、payout_time_ms 与 display_status。

    认证方式: 会话登录调用签发的 Bearer access token

    • payout_transaction_id
    • payout_type
    • payout_type_text
    • payout_total
    • payout_time_ms
    • payout_line_items
    • display_status
    GET /v1/payouts/history HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "items": [
        {
          "payout_transaction_id": "po_6a11c4e8",
          "payout_type": "express_pay",
          "payout_type_text": "Express Pay",
          "payout_total": {"amount": 18450, "currency": "USD", "exponent": 2},
          "payout_time_ms": 1759190400000,
          "payout_line_items": [
            {"amount": {"amount": 18450, "currency": "USD", "exponent": 2}}
          ],
          "display_status": "COMPLETED"
        }
      ]
    }
  • Lyft Direct 借记账户

    GET /v1/debit-card/account openbanking

    读取绑定在司机名下的 Lyft Direct 借记账户:lyftDirectEnabled、账户状态(Active、InReview、CardSuspended、AccountBlocked 等)与卡钱包余额。

    认证方式: 会话登录调用签发的 Bearer access token

    • lyftDirectEnabled
    • status
    • available_balance
    • first_name
    • last_name
    GET /v1/debit-card/account HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "lyftDirectEnabled": true,
      "status": "Active",
      "available_balance": {"amount": 18450, "currency": "USD", "exponent": 2},
      "first_name": "Alex",
      "last_name": "Rivera"
    }
  • 进入司机模式(上线)

    POST /v1/dispatch/go-online opendata

    让合作方上线进入派单状态:提交 GPS 与 vehicle_id,并带有末单与目的地筛选的同级写操作。

    认证方式: 会话登录调用签发的 Bearer access token

    • latitude
    • longitude
    • vehicle_id
    • online
    • current_deactivation_status
    POST /v1/dispatch/go-online HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    Content-Type: application/json
    
    {
      "latitude": 37.7749,
      "longitude": -122.4194,
      "vehicle_id": "veh_7c81f0e2"
    }
    {
      "online": true,
      "vehicle_id": "veh_7c81f0e2",
      "current_deactivation_status": "NONE"
    }
  • 接受行程

    POST /v1/trips/accept opendata

    接受一个预付车费报价,返回乘客卡片、destination_lat/lng 与预估收入区间。同级写操作覆盖到达、接驾、送驾、取消与评价乘客。

    认证方式: 会话登录调用签发的 Bearer access token

    • ride_id
    • route_id
    • offer_id
    • passenger_id
    • passenger_first_name
    • passenger_rating
    • destination_lat
    • destination_lng
    • min_estimated_earnings
    • max_estimated_earnings
    POST /v1/trips/accept HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    Content-Type: application/json
    
    {
      "ride_id": "rid_4e91aa12",
      "route_id": "rte_8c22b1d0",
      "offer_id": "off_11ab99c3",
      "latitude": 37.7749,
      "longitude": -122.4194
    }
    {
      "ride_id": "rid_4e91aa12",
      "route_id": "rte_8c22b1d0",
      "passenger_id": "pax_55c1d0aa",
      "passenger_first_name": "Jordan",
      "passenger_rating": 4.88,
      "destination_lat": 37.7849,
      "destination_lng": -122.4094,
      "min_estimated_earnings": {"amount": 1200, "currency": "USD", "exponent": 2},
      "max_estimated_earnings": {"amount": 1850, "currency": "USD", "exponent": 2}
    }
  • 行程中司机收入

    GET /v1/trips/route-earnings openfinance

    读取当前路线的行程中收入面板:送驾后展示的 route_payout_total_amount、route_payout_tips_amount 与 estimated_earnings。

    认证方式: 会话登录调用签发的 Bearer access token

    • route_id
    • ride_id
    • route_payout_total_amount
    • route_payout_tips_amount
    • estimated_earnings
    GET /v1/trips/route-earnings HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "route_id": "rte_8c22b1d0",
      "ride_id": "rid_4e91aa12",
      "route_payout_total_amount": {"amount": 2250, "currency": "USD", "exponent": 2},
      "route_payout_tips_amount": {"amount": 400, "currency": "USD", "exponent": 2},
      "estimated_earnings": {"amount": 1850, "currency": "USD", "exponent": 2}
    }
  • 激励活动

    GET /v1/incentives/offers opendata

    列出可选择的冲单挑战与连单奖励活动,带有每周计划器与激励地图渲染所用的 estimated_earnings 区间。

    认证方式: 会话登录调用签发的 Bearer access token

    • offer_id
    • estimated_earnings
    • min_estimated_earnings
    • max_estimated_earnings
    GET /v1/incentives/offers HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "offers": [
        {
          "offer_id": "off_bonus_22",
          "estimated_earnings": {"amount": 2500, "currency": "USD", "exponent": 2},
          "min_estimated_earnings": {"amount": 2000, "currency": "USD", "exponent": 2},
          "max_estimated_earnings": {"amount": 3000, "currency": "USD", "exponent": 2}
        }
      ]
    }
  • 服务质量主页

    GET /v1/quality/home opendata

    加载评分统计所用的服务质量主页:driver_rating、overall_rating 与 qualifying_rating,并带有同级详情与反馈历史读取。

    认证方式: 会话登录调用签发的 Bearer access token

    • driver_rating
    • overall_rating
    • qualifying_rating
    GET /v1/quality/home HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "driver_rating": 4.92,
      "overall_rating": 4.92,
      "qualifying_rating": 4.80
    }
  • 司机欠款

    GET /v1/account/charges openfinance

    读取司机未结费用:debt_amount 与 outstanding_balance_amount,结清前会阻止即时提现。

    认证方式: 会话登录调用签发的 Bearer access token

    • debt_amount
    • outstanding_balance_amount
    • amount
    • currency
    • exponent
    GET /v1/account/charges HTTP/1.1
    Authorization: Bearer eyJhbGciOi...
    {
      "debt_amount": {"amount": 2500, "currency": "USD", "exponent": 2},
      "outstanding_balance_amount": {"amount": 2500, "currency": "USD", "exponent": 2},
      "charges": [
        {"amount": {"amount": 2500, "currency": "USD", "exponent": 2}}
      ]
    }

数据类别

  • 身份
  • 会话
  • 钱包余额
  • 收入汇总
  • 收入动态
  • 每周明细
  • Express Pay
  • 提现历史
  • Lyft Direct
  • 上线接单
  • 行程报价
  • 行程中收入
  • 激励活动
  • 评分
  • 欠款

数据使用场景与案例

  • Express Pay 夜间对账

    拉取 GET /v1/partner-wallet/balance(available_balance、instant_payout_enabled)与 GET /v1/payouts/history(payout_transaction_id、payout_total、payout_time_ms),将每笔即时提现与司机台账逐一核对。

  • 每周收入与小费审计

    组合 GET /v1/earnings/overview(gross_earnings、net_earnings、tip_amount)与 GET /v1/earnings/weekly、GET /v1/earnings/trip-feed(按 ride_id 的 payout_total),重建一周车费加小费的完整活动。

  • 上线合规闸口

    先读 GET /v1/partner/profile 的 current_deactivation_status 与 driver_rating,再携带 vehicle_id 调 POST /v1/dispatch/go-online,通过后才将合作方视为可派单。

  • 预付报价收入叠加

    在 POST /v1/trips/accept 时记录 min_estimated_earnings / max_estimated_earnings 区间,送驾结束后再与 GET /v1/trips/route-earnings(route_payout_total_amount、route_payout_tips_amount)对账。

常见问题

Lyft Driver 如何认证 API 调用?

会话登录调用在手机号、恢复码或通行密钥验证后签发 access_token 与 refresh_token 对。之后每次调用都发送 Authorization: Bearer access_token 并携带区域头。

哪些端点暴露司机收入与小费?

GET /v1/earnings/overview 返回 gross_earnings、net_earnings 与 tip_amount;GET /v1/earnings/trip-feed 按行程分页 payout_total;GET /v1/earnings/weekly 按 payout_period_ms 分组;GET /v1/trips/route-earnings 在行程中补充 route_payout_tips_amount。

即时提现如何运作?

GET /v1/payouts/eligibility 检查 instant_payout_enabled 与可提现的 line_items,GET /v1/partner-wallet/balance 读取 available_balance,随后 POST /v1/payouts/instant 写入提现并返回 payout_transaction_id。历史记录见 GET /v1/payouts/history。

接受行程会返回哪些数据?

POST /v1/trips/accept 接收 ride_id、route_id 与 offer_id,返回 passenger_first_name、passenger_rating、destination_lat/lng 以及 min_estimated_earnings / max_estimated_earnings 区间。到达、接驾、送驾与评价乘客是 /v1/trips/ 下的同级写操作。

与 Lyft Driver 相似的应用

  • Uber - Driver: Drive & Deliver — Uber 的司机端应用:接受叫车与配送订单、追踪收入并提现,是美国司机常与 Lyft Driver 同时运行的主要竞品。
  • DoorDash - Dasher — DoorDash 的 Dasher 配送端提供预付报酬与灵活排班的餐饮配送零工,是网约车司机常用的第二接单应用。
  • Careem Captain — Careem Captain 是 Careem 的司机端应用;Careem 是 Uber 旗下在中东与北非运营的网约车与配送平台。
  • Ola Driver App — Ola Driver 是印度本土网约车平台 Ola 的合作司机端,司机用它接单并查看每日收入。
  • Bolt Driver — Bolt Driver 是 Bolt 的司机端应用;Bolt 在欧洲与非洲运营网约车业务,以价格优势与 Uber 等平台竞争。
  • Grab Driver — Grab Driver 是 Grab 的合作司机端;Grab 是覆盖新加坡、马来西亚、印度尼西亚、越南等东南亚市场的网约车与配送平台。
  • Instacart Shopper — Instacart Shopper 让零工从业者代购并配送生鲜杂货赚取报酬,是对车辆要求更灵活的网约车替代选择。
  • Amazon Flex — Amazon Flex 让司机按预约时段配送亚马逊包裹与生鲜,适合更想送包裹而非载客的司机。

相关主题

  • Lyft Driver API
  • Lyft 司机收入数据
  • Lyft 即时提现
  • Lyft 提现历史
  • Lyft 司机钱包余额
  • Lyft 司机令牌
  • Lyft 接受行程 API
  • Lyft Direct 借记卡

需要集成这个 App 的数据 API?

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。

  • 每个项目均签 NDA 与 SOW
  • 3–7 天交付
  • 验收通过后才付款
  • 仅在授权范围内作业

获取报价