REST API
Документация
Аутентификация
Все запросы требуют API-ключ. Передавайте его одним из способов:
Authorization: Bearer <ваш-ключ>
X-API-Key: <ваш-ключ>
Ключ задаётся переменной окружения API_KEY на сервере.
POST /api/shorten
Сократить ссылку{
"url": "https://example.com/very/long/url"
}
{
"original_url": "https://example.com/very/long/url",
"short_url": "https://s.x-grk.com/aB3xYz",
"short_code": "aB3xYz",
"existing": false
}
curl -X POST https://s.x-grk.com/api/shorten \
-H "Authorization: Bearer <ключ>" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/page"}'
GET /api/stats/<code>
Статистика{
"short_code": "aB3xYz",
"original_url": "https://example.com/very/long/url",
"created_at": "2025-06-03 12:00:00",
"clicks": 42
}
curl https://s.x-grk.com/api/stats/aB3xYz \
-H "Authorization: Bearer <ключ>"
Коды ошибок
400
Некорректный запрос — невалидный URL или заблокированный домен
401
Неверный или отсутствующий API-ключ
404
Короткий код не найден