api · link — fe0.ru

01 статистика

GET /link/api/stats статистика сервиса

Возвращает количество активных ссылок и остаток rate limit для текущего IP.

ответ

{
  "active": 142,
  "remaining": 4,
  "rate_limit": 5
}

02 создать ссылку

POST /link/shorten создать короткую ссылку

Тело запроса — multipart/form-data или application/x-www-form-urlencoded.

параметры

поле	тип	обязательно	описание
long_url	string	да	URL для сокращения, макс. 2048 символов, должен начинаться с http:// или https://
prefix	string	нет	префикс пути: `to`, `u`, `l`, `r` (по умолчанию `to`)
domain	string	нет	`fe0.ru` или `yup.su` (по умолчанию `fe0.ru`)
custom_code	string	нет	кастомный алиас, 2–32 символа, только a-z 0-9 - _
ttl_hours	integer	нет	срок действия в часах, 0 = бессрочно (по умолчанию 0)
max_clicks	integer	нет	лимит переходов, 0 = без лимита (по умолчанию 0)

ответ 200

{
  "short": "https://fe0.ru/to/b5o",
  "code": "b5o",
  "prefix": "to",
  "domain": "fe0.ru",
  "remaining": 3
}

ответ 409 — алиас занят

{ "error": "алиас уже занят" }

ответ 429 — rate limit

{ "error": "лимит исчерпан, подожди минуту" }

Повторный запрос с теми же параметрами возвращает существующую ссылку и не расходует rate limit.

03 переход по ссылке

GET /{prefix}/{code} редирект на оригинальный URL

Редирект 302 на оригинальный URL. Увеличивает счётчик переходов. Если ссылка истекла или исчерпан лимит кликов — редирект на /link.

пример

GET https://fe0.ru/to/b5o
→ 302 https://example.com/very/long/path