API de links curtos - documentação

API JSON para criar e consultar links curtos. Use a chave API da sua conta (ou o API_TOKEN da plataforma, se aplicável).

API pública: https://anyurl.bond - JSON em /api/v1/.

Authorization

Authorization: Bearer 1234

Envie a chave API exata em Authorization: Bearer. O início de sessão no painel usa a mesma chave com o seu e-mail.

POST /api/v1/shorten

{"long_url":"https://example.com","expiration_time":"24h","max_uses":100,"allow_bots":false}

{"long_url":"https://example.com","permanent":true}

Os campos opcionais expiration_time e max_uses aplicam-se ao plano pago. Sem pagamento, há um teto mensal civil (UTC, repor no dia 1) e cada link expira ao fim de ~10 minutos, independentemente do corpo do pedido.

GET /api/v1/info/{short_code}

Devolve metadados e a validade de um código curto sem incrementar cliques.

GET /api/v1/me

Devolve o seu plano, os limites efectivos do painel e o uso do mês (UTC): novas ligações e edições via API.

GET /api/v1/links

?limit=50&offset=0

Lista apenas as ligações curtas criadas com a chave API da sua conta (owner_id corresponde a essa chave; mesmo âmbito que GET /info). O token API da plataforma não pode usar este endpoint. Parâmetros opcionais: limit (predefinição 50, máx. 100), offset (predefinição 0, máx. 100000). JSON: links (os mesmos campos que GET /info por item), total, limit, offset. A listagem não apaga linhas nem incrementa cliques.

PUT / PATCH /api/v1/info/{short_code}

{"long_url":"https://example.com/new","expiration_time":"24h","max_uses":20,"allow_bots":false}

Para alterar um código curto existente, use PUT ou PATCH em /api/v1/info/{short_code} - não POST /shorten. Corpo JSON: qualquer um entre long_url, expiration_time, max_uses, allow_bots. Omita um campo para o manter. Limpe a expiração temporal com expiration_time ""; utilizações ilimitadas com max_uses -1. A resposta segue GET /info.

Exemplos de linha de comandos (curl)

O token 1234 é só um exemplo - use a sua chave API verdadeira. Anfitrião: https://anyurl.bond.

POST /api/v1/shorten - JSON completo (anfitrião https://anyurl.bond)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"expiration_time\":\"24h\",\"max_uses\":100,\"allow_bots\":false}"

POST /api/v1/shorten - corpo mínimo (pago: expiração predefinida 24 h)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

POST /api/v1/shorten - permanente (pago; conta como uma edição inteligente)

curl -sS -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\",\"permanent\":true}"

GET /api/v1/info/{short_code} - exemplo de código curto abc123

curl -sS 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234'

GET /api/v1/me

curl -sS 'https://anyurl.bond/api/v1/me' \
  -H 'Authorization: Bearer 1234'

GET /api/v1/links - paginar as suas ligações curtas

curl -sS 'https://anyurl.bond/api/v1/links?limit=50&offset=0' \
  -H 'Authorization: Bearer 1234'

PATCH /api/v1/info/{short_code}

curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated-destination\"}"

PUT /api/v1/info/{short_code}

curl -sS -X PUT 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com/updated\",\"expiration_time\":\"7d\",\"max_uses\":50,\"allow_bots\":true}"

Verbose (-v) para depuração

curl -v -X POST 'https://anyurl.bond/api/v1/shorten' \
  -H 'Authorization: Bearer 1234' \
  -H 'Content-Type: application/json' \
  -d "{\"long_url\":\"https://example.com\"}"

Plano gratuito da API: até 100 links curtos novos por mês civil (UTC); a contagem repõe-se no dia 1. Cada link expira ao fim de cerca de 10 minutos. Os planos pagos seguem o mesmo ciclo mensal.

Voltar ao início · Termos e condições