命令语法

命令结构

所有命令遵循统一结构：

uqpay <domain> <resource> <action> [flags]

运行uqpay --help可浏览完整命令树；也可以在任意业务域、资源或操作后添加--help，查看其当前字段和flag。

常用资源有顶层快捷方式，可以跳过业务域名：

别名	等价写法
`uqpay beneficiary list`	`uqpay banking beneficiary list`
`uqpay card list`	`uqpay issuing card list`
`uqpay payout list`	`uqpay banking payout list`

通过 flag 传入查询参数：

uqpay banking beneficiary list --page-num 2 --page-size 20

使用-d key=value传入请求体字段。点号记法可以构造嵌套对象。以下片段仅演示语法；运行uqpay beneficiary create --help可查看完整必填字段。

uqpay banking beneficiary create \
  -d entity_type=INDIVIDUAL \
  -d first_name=John \
  -d bank_details.swift_code=DBSSSGSG

值默认按字符串处理。命令会自动转换已知的数值字段；其他需要JSON数值的字段应使用num:前缀，例如-d inherit=num:-1。使用str:可强制保留字符串类型。

在文件路径前加 @ 前缀，将本地文件 base64 编码后上传：

-d identity.front_file=@./passport.jpg

Connect 文档上传使用 @+ 前缀，将文件编码为 data URI：

-d "documents[0].front=@+./cert.png"