Soy Rappi 骑手数据 API：登录、资料、目标与订单

Rappi, Inc - Delivery · 外卖

Soy Rappi（Sé un repartidor）是 Rappi, Inc 推出的骑手端应用。Rappi 是起家于哥伦比亚波哥大的拉美即时配送超级应用，其骑手被称为 Rappitenderos，而这款应用就是他们在巴西接单干活的工具。骑手凭邮箱、短信或 WhatsApp 收到的一次性验证码登录，在标出高需求区域的首页地图上上线，领取打包派发的餐厅与商店订单，依次走完取餐、店内等候和配送各个步骤。投递界面会给出送达地址与地图定位、收件人、地点类型、是否需要代收现金的提示，并要求拍摄账单照片和送达照片作为凭证，需要退回的订单也在这里处理。首页的每日目标卡片把当天收入与骑手在允许区间内自选的目标对照显示；My Profile 页面则展示骑手的接单率、评分、交通工具以及银行账户和卡片的开通状态。在巴西，它主要服务为 Rappi 配送餐饮和杂货的摩托车骑手，在即时配送市场上与 iFood 的骑手应用争夺运力。

订单批次是骑手记录的主干：活动订单流把骑手手上的在途任务归入 orderBundles、activeBundles 与 laggingOrders，其中每笔订单带有 orderId、storeName、orderDate、orderType（餐厅或商店）、如 IN_STORE 这样的流程 status、订单金额 total，以及骑手这一单的 earnings。打开某笔订单，还会得到它的投递信息：address、location 坐标、recipientName、placeType、additionalInfo、cashCollected 标记、billImage、evidenceType 以及 isReturn 退单标识。

围绕这些订单还有三类记录。骑手资料包含 identification、city、transportationMethod、acceptanceRate、average 评分、trusted 与 isActive 状态、storekeeperDebt、hasBankAccount 和 cardActive。每日收入目标把 goalValue 与 totalEarned 对照，并附允许的 goalRange 区间和完成度 percentage。需求热力图配置则携带图层的 radius、刷新间隔 every、实验 treatment 标记，以及启用该图层的 citiesIdsToApply。

车队运营方用 totalEarned 和 goalValue 核对每周打款，并标记 percentage 长期低于设定区间的骑手；调度看板顺着每个 orderId 追到投递详情，在 IN_STORE 订单超过预计时间时告警；调度工具把热力图的半径与启用城市，同骑手的 city 和 transportationMethod 结合，建议摩托车骑手在高峰时段到何处等单；入驻校验则先核查 identification、storekeeperDebt 与银行卡设置，再决定骑手能否继续在线。openData Studio 把这些巴西骑手数据变成上述集成可直接调用的开放数据。

应用截图

API 端点一览

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

骑手邮箱一次性验证码令牌签发
POST /v1/auth/courier/email/verify opendata
用邮箱一次性验证码换取骑手的 Bearer accessToken、refreshToken 与嵌套 profile，供 Soy Rappi 其余所有调用使用。
认证方式：无（本端点用于签发令牌）。请求体携带一次性验证码与发送验证码步骤返回的授权句柄；之后所有调用使用 Bearer accessToken。
- email
- auth
- code
- deviceInformation
- accessToken
- refreshToken
- profile
```
POST /v1/auth/courier/email/verify HTTP/1.1
Content-Type: application/json

{
  "email": "[email protected]",
  "auth": "eyJhbGciOi...",
  "code": "482193",
  "deviceInformation": {"deviceId": "3f2b8c1d-9a1e-4c2b", "os": "android"}
}
```
```
{
  "accessToken": "eyJhbGciOi...",
  "refreshToken": "d8f1c2...",
  "profile": {
    "id": 1843921,
    "firstName": "Camila",
    "lastName": "Souza",
    "email": "[email protected]",
    "phone": "11987654321"
  }
}
```

骑手资料

GET /v1/couriers/me/profile osint

读取已登录骑手的身份、城市、车辆、接单率、欠款与银行 / 卡片标记，驱动 My Profile 与首页。

认证方式：来自 /v1/auth/courier/email/verify 的 Bearer accessToken。

id
identification
firstName
lastName
phone
email
country
city
isActive
trusted
transportationMethod
acceptanceRate
average
storekeeperDebt
hasBankAccount
cardActive

GET /v1/couriers/me/profile HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "id": 1843921,
  "identification": "12345678900",
  "firstName": "Camila",
  "lastName": "Souza",
  "phone": "11987654321",
  "email": "[email protected]",
  "country": "BR",
  "city": "Sao Paulo",
  "isActive": true,
  "trusted": true,
  "transportationMethod": "motorcycle",
  "acceptanceRate": 92,
  "average": "4.8",
  "storekeeperDebt": 0,
  "hasBankAccount": true,
  "cardActive": true
}

每日收入目标
GET /v1/couriers/{courier_id}/daily-goal openfinance
返回骑手配置的每日收入目标与当前 totalEarned 的对比，含允许的 goalRange 区间与完成百分比。
认证方式：来自 /v1/auth/courier/email/verify 的 Bearer accessToken。
- dailyGoal
- goalRange
- goalValue
- totalEarned
- percentage
```
GET /v1/couriers/1843921/daily-goal HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "dailyGoal": {
    "goalRange": {"min": 50, "max": 400},
    "goalValue": 180,
    "totalEarned": 126,
    "percentage": 70
  }
}
```

订单配送详情

GET /v1/orders/{orderId}/dropoff-detail opendata

返回进行中订单的投递信息包：配送步骤页使用的地址、坐标、收件人、现金收款标记与凭证类型。

认证方式：来自 /v1/auth/courier/email/verify 的 Bearer accessToken。

address
location
flow
additionalInfo
billImage
isReturn
recipientName
placeType
storekeeperId
cashCollected
evidenceType

GET /v1/orders/99887766/dropoff-detail HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "address": "Rua Augusta 1500, Apto 42",
  "location": {"lat": -23.5614, "lng": -46.6558},
  "flow": "STANDARD",
  "additionalInfo": "Leave at reception",
  "billImage": "https://cdn.example/bills/99887766.jpg",
  "isReturn": false,
  "recipientName": "Joao Lima",
  "placeType": "apartment",
  "storekeeperId": 1843921,
  "cashCollected": false,
  "evidenceType": "PHOTO"
}

需求热力图分布
GET /v1/demand/heatmap/config opendata
为首页地图的需求叠加层供数：热力图半径、刷新间隔、实验 treatment 标记与启用该图层的城市 id。
认证方式：来自 /v1/auth/courier/email/verify 的 Bearer accessToken。
- treatment
- radius
- every
- version
- citiesIdsToApply
```
GET /v1/demand/heatmap/config?lat=-23.5614&lng=-46.6558&radius=1500 HTTP/1.1
Authorization: Bearer eyJhbGciOi...
```
```
{
  "treatment": true,
  "radius": 1500,
  "every": 60,
  "version": "v1",
  "citiesIdsToApply": [1, 4, 9]
}
```

按状态列出活动订单

GET /v1/orders/active opendata

按工作流状态列出骑手进行中的订单包与滞后订单，让首页可以恢复取货、店内与配送各步骤。

认证方式：来自 /v1/auth/courier/email/verify 的 Bearer accessToken。

laggingOrders
orderBundles
activeBundles
id
orderId
storeName
orderDate
total
orderType
status
earnings
userId

GET /v1/orders/active HTTP/1.1
Authorization: Bearer eyJhbGciOi...

{
  "laggingOrders": [],
  "orderBundles": [{
    "id": "bdl_01",
    "orders": [{
      "id": "ord_99887766",
      "orderId": 99887766,
      "storeName": "Burger House Paulista",
      "orderDate": "2026-09-24T18:12:03Z",
      "total": 42.9,
      "orderType": "RESTAURANT",
      "status": "IN_STORE",
      "earnings": 8.5,
      "userId": 552109
    }]
  }],
  "activeBundles": [],
  "isFirebaseActive": true
}

数据类别

认证令牌
骑手资料
收入目标
配送详情
需求热力图
活动订单

数据使用场景与案例

骑手薪资核对
车队运营机器人拉取每位骑手的每日目标 totalEarned 与 goalValue，同每周打款核对，标记 percentage 长期低于所配置 goalRange 的骑手。
实时配送 SLA 监控
调度看板盯守活动订单流，对每个 orderId 打开投递详情读取 recipientName、location 与 cashCollected，当某个 IN_STORE 订单停留超过预计送达时间时触发告警。
按需求热力调配骑手站位
调度工具读取热力图分布（radius、every、citiesIdsToApply），结合骑手资料中的 city 与 transportationMethod，建议摩托车骑手在高峰时段到何处等单。
KYC 与欠款筛查
入驻校验使用骑手资料中的 identification、hasBankAccount、cardActive 与 storekeeperDebt 字段，判断骑手可以继续在线接单，还是必须先完成银行卡设置。

常见问题

Soy Rappi 如何对骑手进行身份验证？

骑手先请求邮箱（或短信 / WhatsApp）一次性验证码，然后向 /v1/auth/courier/email/verify 提交 email、auth、code 与 deviceInformation。响应携带 accessToken、refreshToken 与嵌套的 profile；后续调用发送 Authorization: Bearer accessToken。

哪些字段描述骑手的每日收入目标？

GET /v1/couriers/{courier_id}/daily-goal 返回 dailyGoal，内含 goalRange、goalValue、totalEarned 与 percentage——与应用内每日目标卡片上展示的数字一致。

投递地址来自哪里？

GET /v1/orders/{orderId}/dropoff-detail 返回配送步骤页所需的 address、location、recipientName、placeType、cashCollected 与 evidenceType。

需求热力图如何更新？

应用携带骑手的 lat/lng 与 radius 调用 GET /v1/demand/heatmap/config，返回的载荷包含 treatment、radius、every（刷新间隔秒数）、version 与 citiesIdsToApply。

与 Soy Rappi - Sé un repartidor 相似的应用

iFood para Entregadores — iFood 的骑手应用是巴西外卖骑手的首选替代平台，骑手上线后接收餐饮订单并跟踪每笔配送的收入。
PedidosYa Repartidor — PedidosYa 的骑手应用覆盖 15 个拉丁美洲市场，为骑手配送餐饮、杂货与药品订单。
Loggi — Loggi 是巴西的末端物流应用，其骑手配送包裹、文件与电商订单，而非餐饮外卖。
Lalamove — Lalamove 是一款即时配送应用，自 2019 年起在巴西多个城市运营，司机可用摩托车、汽车、面包车或卡车配送订单。
Uber Driver — Uber 的司机应用让合作伙伴在同一应用内于网约车行程与 Uber Eats 餐饮配送之间切换。
99 Entregas — 99 的配送业务由 DiDi 支持并集成在 99 网约车应用中，是巴西骑手从事配送工作的另一平台。
DoorDash Dasher — DoorDash 的 Dasher 应用是一款广泛使用的骑手应用，司机在其中接收并配送餐饮订单、跟踪收入，是 Soy Rappi 的近功能类应用。

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

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

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

获取报价

Soy Rappi 骑手数据 API：登录、资料、目标与订单

应用截图

API 端点一览

骑手邮箱一次性验证码令牌签发

骑手资料

每日收入目标

订单配送详情

需求热力图分布

按状态列出活动订单

数据类别

数据使用场景与案例

骑手薪资核对

实时配送 SLA 监控

按需求热力调配骑手站位

KYC 与欠款筛查

常见问题

相关应用

与 Soy Rappi - Sé un repartidor 相似的应用

相关主题

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