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 YOUR_API_KEY

Envoyez la clé API exacte en en-tête Authorization: Bearer. Par défaut, le tableau de bord utilise uniquement la clé API ; la page e-mail sert à saisir votre mot de passe.

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)

YOUR_API_KEY est un simple exemple. Utilisez votre vraie clé API. Exemples avec 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 YOUR_API_KEY' \
  -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 YOUR_API_KEY' \
  -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 YOUR_API_KEY' \
  -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 YOUR_API_KEY'

GET /api/v1/me

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

GET /api/v1/links - pagination de vos liens courts

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

PATCH /api/v1/info/{short_code}

curl -sS -X PATCH 'https://anyurl.bond/api/v1/info/abc123' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -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 YOUR_API_KEY' \
  -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 YOUR_API_KEY' \
  -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