API skracania linków - dokumentacja

API JSON do tworzenia i sprawdzania skróconych linków. Użyj klucza API przypisanego do konta (lub platformowego API_TOKEN, jeśli dotyczy).

Publiczne API: https://anyurl.bond - JSON pod /api/v1/.

Authorization

Authorization: Bearer 1234

Wyślij dokładny klucz API w nagłówku Authorization: Bearer. Logowanie do panelu wymaga tego samego klucza i e-maila.

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}

Opcjonalne expiration_time i max_uses dotyczą planu płatnego. Bez płatności obowiązuje miesięczny limit kalendarzowy (UTC, reset 1.), a każdy link wygasa po ok. 10 minutach niezależnie od treści żądania.

GET /api/v1/info/{short_code}

Zwraca metadane i ważność skrótu bez zwiększania liczby kliknięć.

GET /api/v1/me

Zwraca poziom planu, skuteczne limity z panelu i zużycie w bieżącym miesiącu (UTC): nowe linki i zmiany przez API.

GET /api/v1/links

?limit=50&offset=0

Wypisuje tylko skrócone linki utworzone kluczem API konta (owner_id = ten klucz; ten sam zakres co GET /info). Token API platformy nie może wywołać tego endpointu. Parametry: limit (domyślnie 50, max 100), offset (domyślnie 0, max 100000). JSON: links (te same pola co GET /info na element), total, limit, offset. Lista nie usuwa wierszy ani nie zwiększa kliknięć.

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

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

By zmienić istniejący kod skrótu, użyj PUT lub PATCH na /api/v1/info/{short_code} - nie POST /shorten. Treść JSON: dowolne z long_url, expiration_time, max_uses, allow_bots. Pomiń pole, by je zostawić. Wyłącz wygaśnięcie czasowe przez expiration_time ""; nielimitowane użycia przez max_uses -1. Odpowiedź jak przy GET /info.

Przykłady wiersza poleceń (curl)

Token 1234 to tylko przykład - użyj prawdziwego klucza API. Host: https://anyurl.bond.

POST /api/v1/shorten - pełny JSON (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 - minimalne ciało (płatne: domyślne wygaśnięcie 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 - stały link (płatne; zajmuje jedną edycję „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} - przykładowy kod skrótu 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 - stronicowanie Twoich skróconych linków

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) do debugowania

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

Warstwa darmowa API: do 100 nowych skróconych linków na miesiąc kalendarzowy (UTC); limit odnawia się pierwszego dnia miesiąca. Pojedynczy link wygasa po około 10 minutach. Płatne plany stosują ten sam miesięczny cykl.

Strona główna · Regulamin