SuperAPI AI 工具集

awardwallet

通用与其它

查看项目

更新于 10-15 17:29

技能介绍

用途:通过 AwardWallet Business Account Access API 查询忠诚度计划的积分余额、精英会籍状态和交易历史,适合查看积分库存、航空会籍或规划行程。数据源为 business.awardwallet.com,需要 Business 账户。

认证:在 .env 中设置 AWARDWALLET_API_KEY(从 https://business.awardwallet.com/profile/api 获取)和 AWARDWALLET_USER_ID(可通过 List Connected Users 端点查找)。所有请求使用 X-Authentication 请求头。注意:Business API 密钥强制 IP 白名单,未加入白名单会返回 {"error": "access_denied", "code": "IP_DENIED"},需先在上述地址加入当前 IP(可用 curl ifconfig.me 查询);多 IP 环境(家庭、办公室、热点、VPN 出口等)需分别添加。

API 基础地址:https://business.awardwallet.com/api/export/v1

主要能力:获取全部余额(GET /connectedUser/{userId});查看单个账户完整历史(GET /account/{accountId},默认仅返回最近 10 条);获取行程时间线(POST /travel-timeline/{userId},传 start/end 日期);列出支持的提供商(GET /providers/list)。账户对象含 accountId、code、displayName、kind、balance、balanceRaw、properties、history、errorCode 等字段。properties 的 kind 值标准化:1 账号、2 到期、3 精英会籍、4 终身积分、5 入会时间、6 即将过期余额、7 年度里程、8 年度航段、9 下一等级、10 升级所需积分、11 升级所需航段、12 姓名、13 最近活动、14 下一奖励所需积分、15 会籍到期、16 保级积分、17 保级航段、18 联盟会籍、19 定级里程。

使用方式:可用 curl 配合 jq 过滤,例如按 kind 筛选 Airlines、Hotels、Credit Cards,按余额排序,提取精英会籍,或找出 errorCode 非 1 的异常账户。

限制:历史记录在用户详情响应中最多 10 条;balanceRaw 为数值,balance 带逗号格式;连接用户可自行控制共享级别,数据可能受限;Capital One 等计划存在 subAccounts 数组需检查。错误码 0 从未更新、1 成功、2 凭据无效、3 锁定、4 提供商错误或需用户操作、5 提供商被禁用、6 解析失败、7 缺少密码、8 为防止锁定被禁用、9 成功但有警告、10 需要安全问题、11 超时。