如何通过API查询Uber账户当前信用额度及促销码到账验证

我来帮你搞定这两个Uber API操作的具体步骤和验证方法：

1. 应用促销码（PATCH /me）及验证信用到账 #

首先，调用PATCH /me端点应用促销码需要满足两个核心条件：一是你得有有效的用户授权令牌（Bearer Token），权限至少覆盖profile和payment相关 scope；二是请求体要以JSON格式传递促销码。

示例Curl请求 #

curl -X PATCH "https://api.uber.com/v1/me" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "promo_code": "YOUR_TARGET_PROMO_CODE"
  }'

验证信用是否成功到账 #

有两种可靠的验证方式：

• 即时检查响应：如果促销码应用成功，接口返回的JSON里会包含promotions数组，其中会新增一条对应你刚应用的促销记录，里面明确标注了信用额度、有效期等信息，直接核对这些字段即可。
• 对比余额变化：调用下面的余额查询接口，对比应用促销码前后的余额数值，确认额度已经增加。

2. 查询当前账户信用余额 #

要获取账户的实时信用余额，最直接的方式是调用GET /v1/me/wallet/balance端点，这个接口专门返回钱包的详细余额数据。

示例Curl请求 #

curl -X GET "https://api.uber.com/v1/me/wallet/balance" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

响应关键字段说明 #

成功响应会包含这些核心信息：

• balance: 当前账户的总信用余额
• currency_code: 余额对应的货币代码（如USD、CNY）
• promotions_balance: 单独统计的促销信用余额（部分场景下会区分基础余额和促销余额）
• expiration_date: 信用的有效截止日期（如果促销有时间限制）

如果你只需要快速获取包含基础余额的用户概览，也可以调用GET /v1/me端点，响应中的wallet字段会提供简化版的余额信息，但不如专门的余额接口详细。

注意事项 #

• 确保你的访问令牌拥有payment:read权限，否则会返回权限不足的错误。
• 如果应用促销码失败，接口会返回明确的错误码（比如promo_code_invalid、promo_code_already_applied），可以根据这些提示排查问题。

内容的提问来源于stack exchange，提问作者ykrafty