Cloudflare Link Shortener icon

Cloudflare Link Shortener

CRUD de links curtos no Workers KV. Com provisionamento automático: cria namespace, publica Worker de redirect e associa o hostname da Base da URL curta na Cloudflare.

Listar Chaves

AI-generated

Summary

List keys stored in the configured Cloudflare Workers KV namespace, optionally filtered and paginated, and optionally fetch each key's corresponding value data.

Inputs

  • Provisionar infra automaticamente — Boolean to automatically provision Cloudflare KV namespace, deploy Worker script, and register base URL hostname if needed (requires appropriate API token permissions). Disable if infrastructure is managed manually.
  • Limite — Maximum number of keys to return in this API page (1-1000).
  • Prefixo — Optional string to filter keys starting with this prefix.
  • Cursor — Token from previous response's pagination (result_info.cursor) to fetch the next page.
  • Buscar Destinos — Boolean to fetch the value of each key individually (incurs one API request per key; recommended only with low limit).

Output shape

a single JSON object containing 'links', an array of keys with their slugs and short URLs, plus optional details; also includes 'next_cursor' for pagination and 'count' of returned items.

Supports cursor-based pagination via the 'cursor' input parameter. If 'fetchValues' is true, each link record also includes its stored value fields loaded from KV, which requires one additional GET request per key. When auto-provision is enabled, the operation ensures the KV namespace and Worker script are ready before listing keys.

Examples

Example 1: List up to 100 keys with their short URLs

Set 'Limite' to 100, leave 'Prefixo', 'Cursor' blank, 'Buscar Destinos' false or unset.

Example 2: List keys starting with 'campanha-' and fetch their value data

Set 'Prefixo' to 'campanha-', enable 'Buscar Destinos', and limit the page size appropriately to avoid excessive requests.

Links

Discussion