API коротких ссылок - документация

JSON API для создания и проверки коротких ссылок. Используйте ключ API вашего аккаунта (или платформенный API_TOKEN, если применимо).

Публичный API: https://anyurl.bond - JSON в /api/v1/.

Authorization

Authorization: Bearer 1234

Передайте точный API-ключ в Authorization: Bearer. Вход в кабинет использует тот же ключ вместе с 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 и max_uses опциональны для платного тарифа. Без оплаты действует месячный календарный лимит (UTC, сброс 1-го), каждая ссылка истекает ~через 10 минут независимо от тела запроса.

GET /api/v1/info/{short_code}

Возвращает метаданные и пригодность короткого кода без увеличения счётчика переходов.

GET /api/v1/me

Возвращает тариф, действующие лимиты из панели и использование за текущий месяц (UTC): новые ссылки и правки через API.

GET /api/v1/links

?limit=50&offset=0

Перечисляет только короткие ссылки, созданные вашим API-ключом (owner_id совпадает с ключом; тот же охват, что у GET /info). Платформенный API-токен этот метод вызвать не может. Параметры: limit (по умолчанию 50, макс. 100), offset (по умолчанию 0, макс. 100000). JSON: links (поля как у GET /info на элемент), total, limit, offset. Список не удаляет строки и не увеличивает клики.

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

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

Чтобы изменить существующий код, используйте PUT или PATCH на /api/v1/info/{short_code}, а не POST /shorten. Тело JSON: любые из long_url, expiration_time, max_uses, allow_bots. Пропустите поле, чтобы не трогать его. Сбросить срок по времени - expiration_time ""; безлимитные переходы - max_uses -1. Формат ответа как у GET /info.

Примеры командной строки (curl)

Токен 1234 - пример, подставьте свой API-ключ. Хост: https://anyurl.bond.

POST /api/v1/shorten - полный JSON (хост 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 - минимальное тело (платно: по умолчанию срок 24 ч)

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 - постоянная (платно; тратит одно 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} - пример кода 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 - постраничный список ваших ссылок

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) для отладки

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

Бесплатный уровень API: до 100 новых коротких ссылок в календарный месяц (UTC); лимит обнуляется в первый день месяца. Каждая ссылка действует около 10 минут. Платные тарифы используют тот же месячный цикл.

На главную · Условия использования