API 与智能体

短链与二维码 — 面向开发者与 AI 助手。

机器可通过 GET /v1/capabilities 查询当前可用功能；接口文档版本为 OpenAPI 1.6.2。

付费方案尚未开放。

快速上手

创建一条短链，读取 `state`；智能体优先使用 `short_url_ascii`。

1. 调用 `POST /v1/links`（匿名有限额）· 2. 带上 `Idempotency-Key` · 3. `state` 为 `active` 再用链接，否则轮询 `status_url`

curl

curl -sS -X POST 'https://xn--s7y.xn--3ds443g/v1/links' \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"url":"https://example.com/hello"}'

智能体请优先使用 short_url_ascii 或 Punycode 域名。