Все эндпоинты возвращают JSON. Ошибки также возвращаются в JSON с полем error. Rate limiting — по IP-адресу, лимиты указаны для каждого эндпоинта отдельно. При превышении — 429 Too Many Requests.
| код | значение |
|---|---|
| 200 | успех |
| 400 | неверный запрос (описание в поле error) |
| 404 | не найдено |
| 409 | конфликт (алиас уже занят) |
| 429 | превышен rate limit |
| 500 | внутренняя ошибка сервера |
Возвращает количество активных ссылок и остаток rate limit для текущего IP.
{
"active": 142,
"remaining": 4,
"rate_limit": 5
}
Тело запроса — 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) |
{
"short": "https://fe0.ru/to/b5o",
"code": "b5o",
"prefix": "to",
"domain": "fe0.ru",
"remaining": 3
}
{ "error": "алиас уже занят" }
{ "error": "лимит исчерпан, подожди минуту" }
Редирект 302 на оригинальный URL. Увеличивает счётчик переходов. Если ссылка истекла или исчерпан лимит кликов — редирект на /link.
GET https://fe0.ru/to/b5o → 302 https://example.com/very/long/path
| поле | тип | описание |
|---|---|---|
| content | string | текст пасты, макс. 100 000 символов |
| burn | string | on — удалить после первого прочтения (по умолчанию off) |
| ttl | integer | срок жизни в часах, 1–168 (по умолчанию 24) |
{ "id": "xK2mQp_4aB8" }
GET /paste/{id} — HTML-страница. Если burn=on, паста удаляется после первого обращения.| поле | тип | описание |
|---|---|---|
| text | string | текст или URL для кодирования |
| fmt | string | png или svg (по умолчанию png) |
| size | integer | размер модуля в пикселях, 1–40 (по умолчанию 10) |
| error | string | уровень коррекции ошибок: L, M, Q, H (по умолчанию M) |
Бинарный файл изображения с Content-Type image/png или image/svg+xml.
| поле | тип | описание |
|---|---|---|
| content | string | Markdown-текст, макс. 200 000 символов |
Бинарный файл result.docx с Content-Type application/vnd.openxmlformats-officedocument.wordprocessingml.document.
| параметр | описание |
|---|---|
| stacks | через запятую: python, node, go, rust, java, dotnet, unity, terraform, docker, vscode, jetbrains, macos, linux, windows |
Файл .gitignore с Content-Type text/plain.
curl "https://fe0.ru/gitignore/get?stacks=python,docker" -o .gitignore