用途:openydt 是艾科智泊停车开放平台 CLI,本技能是其共享基础规则,所有 openydt 域技能(park/parking/trade/coupon/ticket/device/blacklist/visitor/data 等)执行具体任务前都应先读取本文件,以统一处理配置、签名、状态码、限速与安全。
主要能力:把开放平台接口封装为命令行,自动处理签名鉴权(v2/v3)、多授权商 profile、多环境(test/dev/prod),内置重试与退避;支持三层命令模型——域一等命令(如 openydt park get-auth-park-codes)、各域技能、通用兜底 openydt api <cmd> --body '{...}'。
配置与用法:凭据按 profile 管理,配置文件位于 ~/.config/openydt-cli/config.json(权限 0600)。首次使用:openydt config set --profile demo --key test --secret 123456 --env test --sign v2;随后 openydt config list、openydt config use demo、openydt config path。可用环境变量 OPENYDT_PROFILE/KEY/SECRET/ENV/SIGN/READ_ONLY 覆盖。配置后先运行 openydt auth test 做冒烟验证。全局 flag 包括 --profile、--env、--output、--sign、--yes、--dry-run、--read-only、--verbose、--all-pages、--out。
签名:请求为 POST {base}/openydt/api/v3/{cmd}?sign={sign},带 Authorization: base64(key:ts)。v2 为 lower(md5(key:ts:secret)),v3 含 body。测试 key 通常仅接受 v2。
安全与限制:写操作必须 --yes,建议先 --dry-run;不得明文输出 key/secret;默认在 test 验证,切 prod 前需与用户确认;批量分析用 --all-pages --out 只抽取一次并复用 NDJSON;限速 300 次/分(授权车场数<60),429 遵守 Retry-After。完整状态码与退出码表见 references/status-codes.md,车场经验见 references/park-notes.md。