用途:openydt-park 是 openydt-cli 的车场信息域(park),面向停车场静态与动态信息查询。开始前必须先读取 ../openydt-shared/SKILL.md,掌握认证、profile、签名、状态码、限速与安全规则后再执行命令。
主要能力:查询授权商所有车场、账号下授权车场编码、单个车场基本信息、系统信息(VEMS/云车场)、区域信息、云停车场通道与设备信息;查询单个车场空车位、区域内按经纬度半径的空车位、实时剩余车位、剩余车位与免费时长;按车场编码查收费信息,并对其他车型做计费测算;查询车辆免费停车信息、车辆屏显及语音、车辆优惠券记录(只读);以及设置车场实时车位(写操作)。
使用方式:命令形如 openydt park <use>,均支持 --body '<json>' 传完整请求体,字段也提供同名 flag。多数查询只需 parkCode,可独立调用。唯一有依赖链的是计费测算:先 openydt park get-park-ydt-charge --park-code <parkCode> 拿到查费对象,再把整个返回结果作为 parkYdtChargeVo,并指定 standardSeq、carType、startTime 调用 get-park-ydt-other-car-type-charge-info,这些值必须取自响应,不可臆造。数组/对象型字段(carPlateList、channelCodeList、parkCodes、parkYdtChargeVo、remainCarportList)需通过 --body 传入。写操作 set-park-remain-carport 需先 --dry-run 预览,确认后加 --yes 实发。
适用场景与限制:标注「云停车场」的命令仅对云车场有效,其余 VEMS 传统车场与云车场通用。get-park-ydt-charge 返回的是计费组与按时长档的费用预览估算,不是精确账单;精确算费应使用 trade 域的实时查费。订单/账单/缴费/月票、在场车/进出场、黑白名单、电子券发放核销、设备控制、月票等分别属于其他域。本表未列但属 park 域的接口可用 openydt api <cmd> --body '{...}' 调用。