API de links curtos - documentação

API JSON para criar e consultar links curtos. Use a chave de 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 de API exata em Authorization: Bearer. O login do painel usa a mesma chave com 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}

expiration_time e max_uses opcionais valem para o plano pago. Sem pagamento, há teto mensal civil (UTC, renova no dia 1) e cada link expira em ~10 minutos, independentemente do corpo.

GET /api/v1/info/{short_code}

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

GET /api/v1/me

Retorna seu plano, limites efetivos do painel e o uso do mês (UTC): novos links e edições via API.

GET /api/v1/links

?limit=50&offset=0

Lista apenas links curtos criados com a chave API da sua conta (owner_id corresponde a essa chave; mesmo escopo que GET /info). O token API da plataforma não pode usar este endpoint. Parâmetros opcionais: limit (padrão 50, máx. 100), offset (padrão 0, máx. 100000). JSON: links (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 mantê-lo. Limpe expiração por tempo com expiration_time ""; usos ilimitados com max_uses -1. A resposta segue GET /info.

Exemplos de linha de comando (curl)

O token 1234 é só um exemplo - use a sua chave API real. Host: https://anyurl.bond.

POST /api/v1/shorten - JSON completo (host 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 24 h por predefinição)

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 os seus links curtos

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 renova-se no dia 1. Cada link expira em cerca de 10 minutos. Planos pagos seguem o mesmo ciclo mensal.

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