API de liens courts - documentation

API JSON pour créer et inspecter des liens courts. Utilisez la clé API attribuée à votre compte (ou le jeton API_TOKEN de la plateforme le cas échéant).

API publique : https://anyurl.bond - JSON sous /api/v1/.

Authorization

Authorization: Bearer 1234

Envoyez la clé API exacte en en-tête Authorization: Bearer. La connexion au tableau de bord utilise la même clé avec votre 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}

Les champs optionnels expiration_time et max_uses s’appliquent à l’offre payante. Sans paiement, les nouveaux liens sont plafonnés par mois civil (UTC, reset le 1er) et expirent après environ 10 minutes, quel que soit le corps de la requête.

GET /api/v1/info/{short_code}

Retourne les métadonnées et la validité d’un code court sans incrémenter les clics.

GET /api/v1/me

Renvoie votre offre, les plafonds effectifs du panneau et l’usage du mois civil UTC (nouveaux liens et modifications API).

GET /api/v1/links

?limit=50&offset=0

Liste uniquement les liens courts créés avec votre clé API (owner_id correspond à cette clé ; même périmètre que GET /info). Le jeton API plateforme ne peut pas appeler ce point. Paramètres : limit (défaut 50, max 100), offset (défaut 0, max 100000). JSON : links (mêmes champs que GET /info par élément), total, limit, offset. La liste ne supprime rien ni n’incrémente les clics.

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

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

Pour modifier un code court existant, utilisez PUT ou PATCH sur /api/v1/info/{short_code} - pas POST /shorten. Corps JSON : tout ou partie de long_url, expiration_time, max_uses, allow_bots. Omettez un champ pour le laisser inchangé. expiration_time "" supprime l’expiration temporelle ; max_uses -1 pour des utilisations illimitées. La réponse suit GET /info.

Exemples en ligne de commande (curl)

Le jeton 1234 est un exemple - utilisez votre vraie clé API. Hôte : https://anyurl.bond.

POST /api/v1/shorten - JSON complet (hôte 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 - corps minimal (payant : expiration 24 h par défaut)

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 - permanent (payant ; compte comme une édition « smart »)

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} - exemple de code court 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 - pagination de vos liens courts

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) pour le débogage

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\"}"

Offre API gratuite : jusqu’à 100 nouveaux liens courts par mois civil (UTC), le compteur est réinitialisé le 1er du mois. Chaque lien expire après environ 10 minutes. Les offres payantes suivent le même rythme mensuel.

Retour à l’accueil · Conditions générales