SuperAPI AI 工具集

openydt-api-explorer

编程与开发

查看项目

更新于 10-16 01:30

技能介绍

用途:openydt-api-explorer 面向 openydt CLI,当某接口没有专属一等命令时,提供通用兜底调用与接口探索能力。执行前须先用 Read 读取 ../openydt-shared/SKILL.md 了解认证、profile、签名、状态码、限速与安全规则;api 与一等命令共用同一套签名、包络、退出码与限速逻辑。

主要能力:可用 openydt api <cmd> --body '{...}' 直发任意 direction=callable 的业务编码,覆盖未做成一等命令的域,如 cityOperationCoupon、thirdParkForBolian、upward、community、ad、preferential/score、invoice、ydtUser 等,以及月票预约/排队、月票授权访客、月票证件规则、车辆标签等未一等化子特性。选择顺序为先找一等命令,找不到再用 api 兜底。

使用方式:支持行内 JSON body、无参省略 body、--body-file 从文件读取、--body-file - 从 stdin 读取;--body 与 --body-file 互斥,二者都不给则发送空 body。body 会先做 JSON compact 再用于签名。参数命名与嵌套照搬接口定义。可用 --dry-run 预览签名请求(URL/sign/ts/body),不实际发送。写操作(catalog readwrite=write)必须加 --yes,否则被写守护拦截;全局 --read-only 或 OPENYDT_READ_ONLY=1 下所有写操作被拒绝。

从 catalog 查参数:读取 catalog/catalog.json,其 interfaces 数组含 cmd、domain、direction、readwrite、included、params、sampleBody、sampleResponse 等字段,可用 jq 按 cmd 或域检索。included=false 只表示未生成一等命令,只要 direction=callable 仍可用 api 调用;readwrite 决定是否需 --yes。

限制:direction=webhook 的接口是平台主动推送,不能主动调用,需自建 HTTP 接收端并登记回调地址;cmd 拼错或误调 webhook 会返回接口不存在。body 字段名或必填错误会返回参数错误。示例中的车场与时间为测试值,照抄历史 sampleBody 可能遇到无效车场或过期有效期。