SuperAPI AI 工具集

openydt-monthticket

办公与效率

查看项目

更新于 10-16 06:47

技能介绍

用途:处理月票、VIP、会员包月、特殊车辆(访客、黑名单)与车辆身份相关业务,如开通/续费/退费/取消月票、管理月票类型、查询月票记录与将过期月票、冻结解冻、创建访客或黑名单 VIP 组。

使用前提:开始前必须先用 Read 工具读取 ../openydt-shared/SKILL.md(认证、profile、签名、状态码、限速、安全规则),未读共享基座不要执行任何命令。

主要能力:命令格式为 openydt ticket <use>,共 29 条已收录命令。读操作直接用对应 get-* 命令,无需 --yes;写操作(创建、修改、开通、续费、退费、取消、冻结)必须加 --yes,否则被 f.ConfirmWrite 拦截。参数以 openydt ticket <cmd> --help 为准。

典型流程:创建月票类型(add-online-month-ticket-type)后从响应取 data.monthTicketConfigId;开通线上月票(add-online-month-ticket)后取 data.monthTicketId 用于续费、退费、修改;查询可用 get-online-month-ticket-list、get-online-month-ticket-by-car-card、get-online-vip-ticket。金额单位为元;billCode/thirdpartyBillCode/thirdpartyIdentify 是幂等键,重试须复用首次值,收到 907 表示幂等命中,应改查确认而非重发。

特殊车辆类型:add-special-car-type 创建,vipGroupType=1 为访客、2 为黑名单,其类型 ID 供 openydt visitor 与 openydt blacklist 复用;名单成员管理不在本域。

限制:临停实时算费请用 openydt trade get-park-fee;月票预约/排队、月票授权访客、月票证件规则、线下月卡、VIP 类型扩展等未一等化接口需用 openydt api 兜底。示例中的 parkCode 与时间为测试值,ID 类参数须取自上一步响应,不要照抄。