nurl-key 短链管理

nurl-key 是 Short_NURL 的远程短链管理工具，通过无头 API（headless）远程操作短链，需要网络连接。

本文档使用 {花括号} 标记占位符，使用时请替换为实际值：

一、运行方式

cd {项目目录}

php nurl-key -h

二、命令总览

三、参数

参数支持两种赋值格式：

四、使用示例

1. 创建短链

php nurl-key -key:"{su_你的Key}" -add -url:"{目标长链接}" -ttl:0

正在创建短链...
创建成功 ✓
  短链：{完整短链地址}

创建接口成功时固定返回 HTTP 200，响应字段如下：

当 synced=false 时，nurl-key 会在标准错误中显示服务端的 warning；当 key_consumed=true 时，会提示该一次性密钥不可再次使用。

2. 查询短链

php nurl-key -key:"{su_你的Key}" -list

列表接口返回 permanent 和 temporary 两个数组。每条记录均包含 id、url、lurl、exp；永久短链的 exp 为字符串 "permanent"，临时短链为 ISO 8601 时间。过期临时短链会被过滤。

3. 删除短链

php nurl-key -key:"{su_你的Key}" -rm -code:"{短链后缀}"

删除接口返回 { "ok": true, "synced": true|false }。当 synced=false 时，冷存储已经删除成功，但热存储可能仍在短时间内保留旧条目，客户端会显示缓存延迟警告。

4. 查看单条短链

php nurl-key -key:"{su_你的Key}" -get "{短链后缀}"

单条查询返回 id、url、lurl、exp。永久短链的 exp 为 "permanent"；临时短链为 ISO 8601 时间；已过期临时短链返回 404 expired。

5. 查看配额状态

php nurl-key -key:"{su_你的Key}" -stat

配额接口以冷存储计数为准，返回 perm_count、temp_count、perm_limit、temp_limit、hot_available；热存储可用时还会返回 hot_perm_count、hot_temp_count。当前 nurl-key 只显示前四项，且接口中的 perm_limit / temp_limit 是普通用户配额字段，不会改写为服务密钥的 svc_perm_limit / svc_temp_limit。

6. 密钥权限

五、错误处理