# 短.在线

> Short links + QR codes for AI agents. Account required to create links via API or MCP. Public beta.

- name: xn--3ds443g.xn--s7y/duan-online
- version: 1.6.5
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 76/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/xn--3ds443g.xn--s7y%2Fduan-online
- tools: https://api.protogrid.dev/v1/servers/xn--3ds443g.xn--s7y%2Fduan-online/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "duan-online": {
      "type": "http",
      "url": "https://xn--s7y.xn--3ds443g/mcp",
      "headers": {
        "Authorization": "Bearer ${DUAN_ONLINE_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${DUAN_ONLINE_TOKEN}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-3d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 76/100 (good)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 2 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 6 of 6 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 2,512 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 39 tool changes in 30 days
- fail `stability.rug_pull`: 7 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 6, about 2,512 tokens to load them all
- tool set hash: bf96867c6c353c780697aef8b2ab4ca4
- tools last changed: 2026-10-17T17:39:26.992Z
- badge: [![protogrid quality](https://protogrid.dev/badge/xn--3ds443g.xn--s7y/duan-online.svg)](https://protogrid.dev/servers/xn--3ds443g.xn--s7y/duan-online)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-17 `begin_registration` changed (description)
  - before: 客户端无法启动 OAuth 时的后备入口。返回浏览器注册链接。本工具不创建账户，不接收密码，也不代用户同意条款。 Fallback when the client cannot start OAuth. Returns a browser registration link. This tool does not create an account, accept a password, or accept terms for the user.
  - after: 客户端无法启动 OAuth 时的后备入口。返回浏览器注册链接。本工具不创建账号，不接收密码，也不代用户同意条款。 Fallback when the client cannot start OAuth. Returns a browser registration link. This tool does not create an account, accept a password, or accept terms for the user.
- 2026-10-17 `create_qr` changed (description, outputSchema)
  - before: 为已有短链返回可扫描二维码。默认 PNG 512×512，并包含 image/png 图片块。仅当 format 为 svg 时返回 SVG，且不以 image 块返回。二维码中编码的是带有 ?s=qr 来源标记的短链接（使用 ASCII 域名），与 GET /v1/links/{id}/qr 返回的二维码内容一致。需要已注册账户，且必须是该链接的所有者。不新建短链，也不抓取目标地址。PNG 边长仅 256、512、1024，SVG 忽略边长。可能包含短期 image_url 及其到期时间；该链接不是 API key、OAuth 令牌或会话。请向用户展示返回的图片或提供 image_url。不要自行生成、绘制或合成二维码，也不要将自行生成的二维码标注为本连接器的返回结果。客户端无法显示图片时，请提供返回的 image_url（如有）或短链。 Return a scannable QR for an existing short link. Default PNG is 512×512 and includes an image/png image block. SVG is returned only when format is svg, and not as an image block. The matrix encodes the tracking URL with ?s=qr (ASCII host), the same payload as GET /v1/links/{id}/qr. A registered account that owns the link is required. Does not create a link and does not fetch the destination. PNG size is 256, 512, or 1024. SVG ignores size. A short-lived image_url and its expiry may be included. That URL is not an API key, an OAuth token, or a session. Show the user the returned image or image_url. Do not generate, draw, or synthesize a QR code, and do not claim a QR you made came from this connector. If the client cannot display the image, give the user the returned image_url when one is present, or the short link.
  - after: 为已有短链返回可扫描二维码。默认 PNG 512×512，并包含 image/png 图片块。仅当 format 为 svg 时返回 SVG，且不以 image 块返回。二维码中编码的是带有 ?s=qr 来源标记的短链接（使用 ASCII 域名），与 GET /v1/links/{id}/qr 返回的二维码内容一致。需要已注册账号，且必须是该链接的所有者。不新建短链，也不抓取目标地址。PNG 边长仅 256、512、1024，SVG 忽略边长。可能包含短期 image_url 及其到期时间；该链接不是 API 密钥、OAuth 令牌或会话。返回已存储短链的二维码：默认 PNG，请求时为 SVG；可用时附带短期 image_url。二维码编码的是 qr_tracking_url。未显示图片时，可使用 image_url（如有）或短链。 Return a scannable QR for an existing short link. Default PNG is 512×512 and includes an image/png image block. SVG is returned only when format is svg, and not as an image block. The matrix encodes the tracking URL with ?s=qr (ASCII host), the same payload as GET /v1/links/{id}/qr. A registered account that owns the link is required. Does not create a link and does not fetch the destination. PNG size is 256, 512, or 1024. SVG ignores size. A short-lived image_url and its expiry may be included. That URL is not an API key, an OAuth token, or a session. Returns the stored link's QR as PNG, or SVG when requested, with a short-lived image URL where available. The QR encodes qr_tracking_url. Where an image is not displayed, image_url (when present) or the short link reaches the same code.
- 2026-10-17 `resolve_short_url` changed (description)
  - before: 查询本站短码或本站短链的已保存状态；仅 active 时返回目标地址。无需账户。不查询其他短链服务；查询结果不是安全检测结论。 Look up a 短.在线 code or short URL and return its saved state. The destination is returned only when active. No account required. Does not look up other shorteners. The result is not a security verdict.
  - after: 查询本站短码或本站短链的已保存状态；仅 active 时返回目标地址。无需账号。不查询其他短链服务；查询结果不是安全检测结论。 Look up a 短.在线 code or short URL and return its saved state. The destination is returned only when active. No account required. Does not look up other shorteners. The result is not a security verdict.
- 2026-10-17 `shorten_urls` changed (description)
  - before: 一次同步创建 1 到 100 条短链。按 client_ref 对应结果，允许部分成功。需要已注册账户。批量重试只有三种情况，不要混用。示例：key 为 batch-1，两项 client_ref 分别为 notes（https://example.com/notes）和 draft（https://example.com/draft）。notes 成功，draft 的 retryable 为 true。(1) 传输结果不确定（没有拿到已完成的响应、IDEMPOTENCY_IN_PROGRESS、幂等锁不可用，或因瞬时数据库错误且一条都未创建而返回 503）：用同一个 key 原样重发整批。已完成的批次返回已保存的结果，notes 不会再次创建。key 已被释放时，同一批会重新执行。(2) 已完成且某项 retryable 为 true：重放 batch-1 只返回已保存的结果，不会重试 draft。只用新 key（例如 batch-1-draft）发送 draft，并保留 client_ref draft，不要带上 notes。去掉 notes 后仍用 batch-1 会返回 IDEMPOTENCY_CONFLICT。(3) 校验错误：改正请求，不要把同一份无效请求当作网络重试。key 尚未保存的 400（重复 client_ref、缺少 items、BATCH_TOO_LARGE）改正后可以继续用同一个 key。已完成且 retryable 为 false 的项已保存；修改请求体后继续使用原 key，会返回 IDEMPOTENCY_CONFLICT，改正后的项必须用新 key。 Create 1 to 100 short links in one synchronous request. Match each result by client_ref. Partial success is allowed. A registered account is required. Batch retry has three cases; do not mix them. Worked example: key batch-1 with client_ref notes (https://example.com/notes) and draft (https://example.com/draft). notes succeeds and draft is retryable true. (1) Uncertain transport outcome — no completed body, IDEMPOTENCY_IN_PROGRESS, an unavailable idempotency lock, or 503 because a transient database error created nothing: resend the entire unchanged batch with the same key. A completed batch returns the stored result and notes is not created again. A released key runs that same batch again. (2) Completed batch with retryable true: replaying batch-1 returns the stored body and does not retry draft. Send only draft, keeping client_ref draft, under a new key such as batch-1-draft. Do not include notes. Dropping notes and reusing batch-1 returns IDEMPOTENCY_CONFLICT. (3) Validation error: fix the request. Do not resend the same invalid body as a network retry. A 400 before the key is stored (duplicate client_ref, missing items, BATCH_TOO_LARGE) may reuse the key after the body is corrected. A completed item with retryable false is stored; a changed body on that key returns IDEMPOTENCY_CONFLICT, so send the corrected item with a new key.
  - after: 一次同步创建 1 到 100 条短链。按 client_ref 对应结果，允许部分成功。需要已注册账号。批量重试只有三种情况，不要混用。示例：key 为 batch-1，两项 client_ref 分别为 notes（https://example.com/notes）和 draft（https://example.com/draft）。notes 成功，draft 的 retryable 为 true。(1) 传输结果不确定（没有拿到已完成的响应、IDEMPOTENCY_IN_PROGRESS、幂等锁不可用，或因瞬时数据库错误且一条都未创建而返回 503）：用同一个 key 原样重发整批。已完成的批次返回已保存的结果，notes 不会再次创建。key 已被释放时，同一批会重新执行。(2) 已完成且某项 retryable 为 true：重放 batch-1 只返回已保存的结果，不会重试 draft。只用新 key（例如 batch-1-draft）发送 draft，并保留 client_ref draft，不要带上 notes。去掉 notes 后仍用 batch-1 会返回 IDEMPOTENCY_CONFLICT。(3) 校验错误：改正请求，不要把同一份无效请求当作网络重试。key 尚未保存的 400（重复 client_ref、缺少 items、BATCH_TOO_LARGE）改正后可以继续用同一个 key。已完成且 retryable 为 false 的项已保存；修改请求体后继续使用原 key，会返回 IDEMPOTENCY_CONFLICT，改正后的项必须用新 key。 Create 1 to 100 short links in one synchronous request. Match each result by client_ref. Partial success is allowed. A registered account is required. Batch retry has three cases; do not mix them. Worked example: key batch-1 with client_ref notes (https://example.com/notes) and draft (https://example.com/draft). notes succeeds and draft is retryable true. (1) Uncertain transport outcome — no completed body, IDEMPOTENCY_IN_PROGRESS, an unavailable idempotency lock, or 503 because a transient database error created nothing: resend the entire unchanged batch with the same key. A completed batch returns the stored result and notes is not created again. A released key runs that same batch again. (2) Completed batch with retryable true: replaying batch-1 returns the stored body and does not retry draft. Send only draft, keeping client_ref draft, under a new key such as batch-1-draft. Do not include notes. Dropping notes and reusing batch-1 returns IDEMPOTENCY_CONFLICT. (3) Validation error: fix the request. Do not resend the same invalid body as a network retry. A 400 before the key is stored (duplicate client_ref, missing items, BATCH_TOO_LARGE) may reuse the key after the body is corrected. A completed item with retryable false is stored; a changed body on that key returns IDEMPOTENCY_CONFLICT, so send the corrected item with a new key.
- 2026-10-16 `create_qr` changed (description)
  - before: 为已有短链返回可扫描二维码。默认 PNG 512×512，并包含 image/png 图片块。仅当 format 为 svg 时返回 SVG，且不以 image 块返回。矩阵编码带 ?s=qr 的追踪短链（ASCII 主机名），与 GET /v1/links/{id}/qr 相同。需要已注册账户，且必须是该链接的所有者。不新建短链，也不抓取目标地址。PNG 边长仅 256、512、1024，SVG 忽略边长。可能包含短期 image_url 及其到期时间；该链接不是 API key、OAuth 令牌或会话。把返回的图片或 image_url 交给用户。不要自行生成、绘制或合成二维码，也不要声称自己做的二维码来自本连接器。主机无法显示图片时，把链接给用户。 Return a scannable QR for an existing short link. Default PNG is 512×512 and includes an image/png image block. SVG is returned only when format is svg, and not as an image block. The matrix encodes the tracking URL with ?s=qr (ASCII host), the same payload as GET /v1/links/{id}/qr. A registered account that owns the link is required. Does not create a link and does not fetch the destination. PNG size is 256, 512, or 1024. SVG ignores size. A short-lived image_url and its expiry may be included. That URL is not an API key, an OAuth token, or a session. Show the user the returned image or image_url. Do not generate, draw, or synthesize a QR code, and do not claim a QR you made came from this connector. If the host cannot display the image, give the user the link.
  - after: 为已有短链返回可扫描二维码。默认 PNG 512×512，并包含 image/png 图片块。仅当 format 为 svg 时返回 SVG，且不以 image 块返回。二维码中编码的是带有 ?s=qr 来源标记的短链接（使用 ASCII 域名），与 GET /v1/links/{id}/qr 返回的二维码内容一致。需要已注册账户，且必须是该链接的所有者。不新建短链，也不抓取目标地址。PNG 边长仅 256、512、1024，SVG 忽略边长。可能包含短期 image_url 及其到期时间；该链接不是 API key、OAuth 令牌或会话。请向用户展示返回的图片或提供 image_url。不要自行生成、绘制或合成二维码，也不要将自行生成的二维码标注为本连接器的返回结果。客户端无法显示图片时，请提供返回的 image_url（如有）或短链。 Return a scannable QR for an existing short link. Default PNG is 512×512 and includes an image/png image block. SVG is returned only when format is svg, and not as an image block. The matrix encodes the tracking URL with ?s=qr (ASCII host), the same payload as GET /v1/links/{id}/qr. A registered account that owns the link is required. Does not create a link and does not fetch the destination. PNG size is 256, 512, or 1024. SVG ignores size. A short-lived image_url and its expiry may be included. That URL is not an API key, an OAuth token, or a session. Show the user the returned image or image_url. Do not generate, draw, or synthesize a QR code, and do not claim a QR you made came from this connector. If the client cannot display the image, give the user the returned image_url when one is present, or the short link.
- 2026-10-16 `get_link` changed (description)
  - before: 按 id 查询一条链接，仅限已登录账户自己的链接。需要已注册账户。公开状态请用 resolve_short_url。 Fetch one link by id, only a link owned by the signed-in account. A registered account is required. For a public status check, use resolve_short_url.
  - after: 按 id 查询当前授权账号拥有的链接。需要已注册账号。无需账号的公开状态查询请使用 resolve_short_url。 Fetch one link by id, only a link owned by the signed-in account. A registered account is required. For a public status check, use resolve_short_url.
- 2026-10-16 `shorten_urls` changed (description)
  - before: 一次同步创建 1 到 100 条短链。按 client_ref 对应结果，允许部分成功。需要已注册账户。批量重试只有三种情况，不要混用。示例：key 为 batch-1，两项 client_ref 分别为 notes（https://example.com/notes）和 draft（https://example.com/draft）。notes 成功，draft 的 retryable 为 true。(1) 传输结果不确定（没有拿到已完成的响应、IDEMPOTENCY_IN_PROGRESS、幂等锁不可用，或因瞬时数据库错误且一条都未创建而返回 503）：用同一个 key 原样重发整批。已完成的批次返回已保存的结果，notes 不会再次创建。key 已被释放时，同一批会重新执行。(2) 已完成且某项 retryable 为 true：重放 batch-1 只返回已保存的结果，不会重试 draft。只用新 key（例如 batch-1-draft）发送 draft，并保留 client_ref draft，不要带上 notes。去掉 notes 后仍用 batch-1 会返回 IDEMPOTENCY_CONFLICT。(3) 校验错误：改正请求，不要把同一份无效请求当作网络重试。key 尚未保存的 400（重复 client_ref、缺少 items、BATCH_TOO_LARGE）改正后可以继续用同一个 key。已完成且 retryable 为 false 的项已保存；改正文后用原 key 会返回 IDEMPOTENCY_CONFLICT，改正后的项必须用新 key。 Create 1 to 100 short links in one synchronous request. Match each result by client_ref. Partial success is allowed. A registered account is required. Batch retry has three cases; do not mix them. Worked example: key batch-1 with client_ref notes (https://example.com/notes) and draft (https://example.com/draft). notes succeeds and draft is retryable true. (1) Uncertain transport outcome — no completed body, IDEMPOTENCY_IN_PROGRESS, an unavailable idempotency lock, or 503 because a transient database error created nothing: resend the entire unchanged batch with the same key. A completed batch returns the stored result and notes is not created again. A released key runs that same batch again. (2) Completed batch with retryable true: replaying batch-1 returns the stored body and does not retry draft. Send only draft, keeping client_ref draft, under a new key such as batch-1-draft. Do not include notes. Dropping notes and reusing batch-1 returns IDEMPOTENCY_CONFLICT. (3) Validation error: fix the request. Do not resend the same invalid body as a network retry. A 400 before the key is stored (duplicate client_ref, missing items, BATCH_TOO_LARGE) may reuse the key after the body is corrected. A completed item with retryable false is stored; a changed body on that key returns IDEMPOTENCY_CONFLICT, so send the corrected item with a new key.
  - after: 一次同步创建 1 到 100 条短链。按 client_ref 对应结果，允许部分成功。需要已注册账户。批量重试只有三种情况，不要混用。示例：key 为 batch-1，两项 client_ref 分别为 notes（https://example.com/notes）和 draft（https://example.com/draft）。notes 成功，draft 的 retryable 为 true。(1) 传输结果不确定（没有拿到已完成的响应、IDEMPOTENCY_IN_PROGRESS、幂等锁不可用，或因瞬时数据库错误且一条都未创建而返回 503）：用同一个 key 原样重发整批。已完成的批次返回已保存的结果，notes 不会再次创建。key 已被释放时，同一批会重新执行。(2) 已完成且某项 retryable 为 true：重放 batch-1 只返回已保存的结果，不会重试 draft。只用新 key（例如 batch-1-draft）发送 draft，并保留 client_ref draft，不要带上 notes。去掉 notes 后仍用 batch-1 会返回 IDEMPOTENCY_CONFLICT。(3) 校验错误：改正请求，不要把同一份无效请求当作网络重试。key 尚未保存的 400（重复 client_ref、缺少 items、BATCH_TOO_LARGE）改正后可以继续用同一个 key。已完成且 retryable 为 false 的项已保存；修改请求体后继续使用原 key，会返回 IDEMPOTENCY_CONFLICT，改正后的项必须用新 key。 Create 1 to 100 short links in one synchronous request. Match each result by client_ref. Partial success is allowed. A registered account is required. Batch retry has three cases; do not mix them. Worked example: key batch-1 with client_ref notes (https://example.com/notes) and draft (https://example.com/draft). notes succeeds and draft is retryable true. (1) Uncertain transport outcome — no completed body, IDEMPOTENCY_IN_PROGRESS, an unavailable idempotency lock, or 503 because a transient database error created nothing: resend the entire unchanged batch with the same key. A completed batch returns the stored result and notes is not created again. A released key runs that same batch again. (2) Completed batch with retryable true: replaying batch-1 returns the stored body and does not retry draft. Send only draft, keeping client_ref draft, under a new key such as batch-1-draft. Do not include notes. Dropping notes and reusing batch-1 returns IDEMPOTENCY_CONFLICT. (3) Validation error: fix the request. Do not resend the same invalid body as a network retry. A 400 before the key is stored (duplicate client_ref, missing items, BATCH_TOO_LARGE) may reuse the key after the body is corrected. A completed item with retryable false is stored; a changed body on that key returns IDEMPOTENCY_CONFLICT, so send the corrected item with a new key.
- 2026-10-16 `shorten_url` changed (description)
  - before: 创建一个 HTTP 或 HTTPS 短链。需要已注册账户。返回状态；链接为 active 时返回 Unicode 显示地址和 ASCII 地址。两条及以上请用 shorten_urls。重试同一操作须复用同一个 idempotency_key。 Create one HTTP or HTTPS short link. A registered account is required. Returns the state, and when active, the Unicode display URL and the ASCII URL. For two or more, use shorten_urls. A retry of the same operation must reuse the same idempotency_key.
  - after: 为 HTTP 或 HTTPS 目标地址创建一条短链。需要已注册账号。返回链接状态；状态为 active 时，同时返回 Unicode 显示地址和 ASCII 地址。创建两条或更多短链时使用 shorten_urls。重试同一操作时，必须复用相同的 idempotency_key。 Create one HTTP or HTTPS short link. A registered account is required. Returns the state, and when active, the Unicode display URL and the ASCII URL. For two or more, use shorten_urls. A retry of the same operation must reuse the same idempotency_key.
- 2026-10-07 `create_qr` changed (description, outputSchema)
  - before: 为已有短链返回可扫描的二维码图片，默认 PNG 512×512；需要时也可返回 SVG。矩阵编码带 ?s=qr 的追踪短链（ASCII 主机名），与 GET /v1/links/{id}/qr 相同。需要已注册账户，且必须是该链接的所有者。不新建短链，也不抓取目标地址。format 可为 png 或 svg；PNG 边长仅 256、512、1024，SVG 忽略边长。一并返回 qr_tracking_url、MIME 类型与像素边长。 Return a scannable QR image for an existing short link. Default is PNG 512×512; SVG when format is svg. The matrix encodes the tracking URL with ?s=qr (ASCII host), the same payload as GET /v1/links/{id}/qr. A registered account that owns the link is required. Does not create a link and does not fetch the destination. format is png or svg. PNG size is 256, 512, or 1024. SVG ignores size. Also returns qr_tracking_url, MIME type, and pixel size.
  - after: 为已有短链返回可扫描二维码。默认 PNG 512×512，并包含 image/png 图片块。仅当 format 为 svg 时返回 SVG，且不以 image 块返回。矩阵编码带 ?s=qr 的追踪短链（ASCII 主机名），与 GET /v1/links/{id}/qr 相同。需要已注册账户，且必须是该链接的所有者。不新建短链，也不抓取目标地址。PNG 边长仅 256、512、1024，SVG 忽略边长。可能包含短期 image_url 及其到期时间；该链接不是 API key、OAuth 令牌或会话。把返回的图片或 image_url 交给用户。不要自行生成、绘制或合成二维码，也不要声称自己做的二维码来自本连接器。主机无法显示图片时，把链接给用户。 Return a scannable QR for an existing short link. Default PNG is 512×512 and includes an image/png image block. SVG is returned only when format is svg, and not as an image block. The matrix encodes the tracking URL with ?s=qr (ASCII host), the same payload as GET /v1/links/{id}/qr. A registered account that owns the link is required. Does not create a link and does not fetch the destination. PNG size is 256, 512, or 1024. SVG ignores size. A short-lived image_url and its expiry may be included. That URL is not an API key, an OAuth token, or a session. Show the user the returned image or image_url. Do not generate, draw, or synthesize a QR code, and do not claim a QR you made came from this connector. If the host cannot display the image, give the user the link.
- 2026-10-05 `begin_registration` changed (outputSchema)

Full history: https://api.protogrid.dev/v1/servers/xn--3ds443g.xn--s7y%2Fduan-online/changes

## Remotes

- https://xn--s7y.xn--3ds443g/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (6)

- `begin_registration`: 客户端无法启动 OAuth 时的后备入口。返回浏览器注册链接。本工具不创建账号，不接收密码，也不代用户同意条款。 Fallback when the client cannot start OAuth. Returns a browser registration link. This tool does not create an account, accept a password, or accept terms for the user.
- `create_qr`: 为已有短链返回可扫描二维码。默认 PNG 512×512，并包含 image/png 图片块。仅当 format 为 svg 时返回 SVG，且不以 image 块返回。二维码中编码的是带有 ?s=qr 来源标记的短链接（使用 ASCII 域名），与 GET /v1/links/{id}/qr 返回的二维码内容一致。需要已注册账号，且必须是该链接的所有者。不新建短链，也不抓取目标地址。PNG 边长仅 256、512、1024，SVG 忽略边长。可能包含短期 image_url 及其到期时间；该链接不是 API 密钥、OAuth 令牌或会话。返回已存储短链的二维码：默认 PNG，请求时为 SVG；可用时附带短期 image_url。二维码编码的是 qr_tracking_url。未显示图片时，可使用 image_url（如有）或短链。 Return a scannable QR for an existing short link. Default PNG is 512×512 and includes an image/png image block. SVG is returned only when format is svg, and not as an image block. The matrix encodes the tracking URL with ?s=qr (ASCII host), the same payload as GET /v1/links/{id}/qr. A registered account that owns the link is required. Does not create a link and does not fetch the destination. PNG size is 256, 512, or 1024. SVG ignores size. A short-lived image_url and its expiry may be included. That URL is not an API key, an OAuth token, or a session. Returns the stored link's QR as PNG, or SVG when requested, with a short-lived image URL where available. The QR encodes qr_tracking_url. Where an image is not displayed, image_url (when present) or the short link reaches the same code.
- `get_link`: 按 id 查询当前授权账号拥有的链接。需要已注册账号。无需账号的公开状态查询请使用 resolve_short_url。 Fetch one link by id, only a link owned by the signed-in account. A registered account is required. For a public status check, use resolve_short_url.
- `resolve_short_url`: 查询本站短码或本站短链的已保存状态；仅 active 时返回目标地址。无需账号。不查询其他短链服务；查询结果不是安全检测结论。 Look up a 短.在线 code or short URL and return its saved state. The destination is returned only when active. No account required. Does not look up other shorteners. The result is not a security verdict.
- `shorten_url`: 为 HTTP 或 HTTPS 目标地址创建一条短链。需要已注册账号。返回链接状态；状态为 active 时，同时返回 Unicode 显示地址和 ASCII 地址。创建两条或更多短链时使用 shorten_urls。重试同一操作时，必须复用相同的 idempotency_key。 Create one HTTP or HTTPS short link. A registered account is required. Returns the state, and when active, the Unicode display URL and the ASCII URL. For two or more, use shorten_urls. A retry of the same operation must reuse the same idempotency_key.
- `shorten_urls`: 一次同步创建 1 到 100 条短链。按 client_ref 对应结果，允许部分成功。需要已注册账号。批量重试只有三种情况，不要混用。示例：key 为 batch-1，两项 client_ref 分别为 notes（https://example.com/notes）和 draft（https://example.com/draft）。notes 成功，draft 的 retryable 为 true。(1) 传输结果不确定（没有拿到已完成的响应、IDEMPOTENCY_IN_PROGRESS、幂等锁不可用，或因瞬时数据库错误且一条都未创建而返回 503）：用同一个 key 原样重发整批。已完成的批次返回已保存的结果，notes 不会再次创建。key 已被释放时，同一批会重新执行。(2) 已完成且某项 retryable 为 true：重放 batch-1 只返回已保存的结果，不会重试 draft。只用新 key（例如 batch-1-draft）发送 draft，并保留 client_ref draft，不要带上 notes。去掉 notes 后仍用 batch-1 会返回 IDEMPOTENCY_CONFLICT。(3) 校验错误：改正请求，不要把同一份无效请求当作网络重试。key 尚未保存的 400（重复 client_ref、缺少 items、BATCH_TOO_LARGE）改正后可以继续用同一个 key。已完成且 retryable 为 false 的项已保存；修改请求体后继续使用原 key，会返回 IDEMPOTENCY_CONFLICT，改正后的项必须用新 key。 Create 1 to 100 short links in one synchronous request. Match each result by client_ref. Partial success is allowed. A registered account is required. Batch retry has three cases; do not mix them. Worked example: key batch-1 with client_ref notes (https://example.com/notes) and draft (https://example.com/draft). notes succeeds and draft is retryable true. (1) Uncertain transport outcome — no completed body, IDEMPOTENCY_IN_PROGRESS, an unavailable idempotency lock, or 503 because a transient database error created nothing: resend the entire unchanged batch with the same key. A completed batch returns the stored result and notes is not created again. A released key runs that same batch again. (2) Completed batch with retryable true: replaying batch-1 returns the stored body and does not retry draft. Send only draft, keeping client_ref draft, under a new key such as batch-1-draft. Do not include notes. Dropping notes and reusing batch-1 returns IDEMPOTENCY_CONFLICT. (3) Validation error: fix the request. Do not resend the same invalid body as a network retry. A 400 before the key is stored (duplicate client_ref, missing items, BATCH_TOO_LARGE) may reuse the key after the body is corrected. A completed item with retryable false is stored; a changed body on that key returns IDEMPOTENCY_CONFLICT, so send the corrected item with a new key.