2.8 KiB
2.8 KiB
批量购买套餐脚本
该脚本读取只有一列的 CSV,逐条调用 POST /api/admin/orders,为一批资产购买同一个套餐。
脚本仅使用 Python 标准库,不需要安装依赖。默认只预演,必须增加 --execute 才会真实下单。
CSV 格式
首行表头可选,每行填写一个 ICCID 或虚拟号:
identifier
89860000000000000001
VIRTUAL000001
脚本会在请求前检查空文件、多列和重复资产。发现重复资产时整批终止,避免同一资产被重复购买。
预演
python3 scripts/batch_package_purchase/batch_purchase.py \
--base-url https://cmp-api.example.com \
--csv scripts/batch_package_purchase/assets.example.csv \
--package-id 123
预演只校验 CSV 并展示请求示例,不需要 Token,也不会调用接口。
使用已有 Token 执行
推荐通过环境变量传递 Token,避免进入命令历史:
JUNHONG_ADMIN_TOKEN='<后台Access Token>' \
python3 scripts/batch_package_purchase/batch_purchase.py \
--base-url https://cmp-api.example.com \
--csv /path/to/assets.csv \
--package-id 123 \
--execute
使用账号自动登录后执行
未提供 Token 时,可以使用后台账号调用 /api/admin/login 自动获取 Token:
JUNHONG_ADMIN_USERNAME='<后台账号>' \
JUNHONG_ADMIN_PASSWORD='<后台密码>' \
python3 scripts/batch_package_purchase/batch_purchase.py \
--base-url https://cmp-api.example.com \
--csv /path/to/assets.csv \
--package-id 123 \
--execute
也可以使用 --token、--username、--password 参数。密码优先通过环境变量或交互输入,避免保存在 Shell 历史中。
结果文件
默认在输入 CSV 同目录生成:
原文件名_购买结果_YYYYMMDD_HHMMSS.csv
结果包含资产标识、成功或失败状态、HTTP 状态码、业务错误码、错误消息、订单 ID、订单号和订单金额。每处理一条都会立即刷新文件,中途中断时已完成的结果不会丢失。
为避免覆盖历史结果,--output 指定的文件已经存在时脚本会直接报错。
可通过 --output 指定结果路径:
python3 scripts/batch_package_purchase/batch_purchase.py \
--base-url https://cmp-api.example.com \
--csv /path/to/assets.csv \
--package-id 123 \
--output /path/to/result.csv \
--execute
其他参数
--timeout:单次请求超时秒数,默认30。--interval:每次下单后的等待秒数,默认0.2。--execute:显式开启真实下单。
脚本固定使用 wallet 钱包支付,每个资产单独创建一个订单。脚本不会自动重试 POST 请求,避免服务端已成功但客户端未收到响应时重复下单。失败项可根据结果 CSV 人工确认后单独重跑。