// документация

API

Программный интерфейс eblocut.ru — создавай короткие ссылки и получай статистику переходов из своего кода. Подходит для интеграции на другие сайты (сервер‑сервер).

Авторизация

Все запросы к /api/* требуют ключ. Передавай его одним из заголовков:

Authorization: Bearer <ВАШ_КЛЮЧ>

X-API-Key: <ВАШ_КЛЮЧ>

Ключ выдаёт владелец сервиса. Базовый адрес API — https://eblocut.ru

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

POST /api/shorten

Тело запроса — JSON {"url": "…"} или форма url=…. Если схема (http/https) не указана, подставляется https.

Пример запроса

curl -X POST https://eblocut.ru/api/shorten \
  -H "Authorization: Bearer <ВАШ_КЛЮЧ>" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/очень/длинный/путь?a=1"}'

Ответ `201 Created`

{
  "code": "AbC123",
  "short_url": "https://eblocut.ru/AbC123",
  "url": "https://example.com/очень/длинный/путь?a=1",
  "clicks": 0,
  "created_at": "2026-07-22T06:55:00Z"
}

Статистика ссылки

GET /api/links/{code}

Возвращает данные ссылки и актуальное число переходов. 404, если ссылка не найдена.

curl https://eblocut.ru/api/links/AbC123 \
  -H "X-API-Key: <ВАШ_КЛЮЧ>"

Коды ответов

Код	Значение
201	ссылка создана
200	данные получены
400	некорректный URL или JSON
401	нет или неверный API‑ключ
404	ссылка не найдена
503	API выключен (ключ не настроен)

Примеры интеграции

PHP

$ch = curl_init('https://eblocut.ru/api/shorten');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer <ВАШ_КЛЮЧ>',
    ],
    CURLOPT_POSTFIELDS     => json_encode(['url' => $longUrl]),
]);
$data = json_decode(curl_exec($ch), true);
echo $data['short_url'];

Node.js (18+)

const res = await fetch('https://eblocut.ru/api/shorten', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <ВАШ_КЛЮЧ>',
  },
  body: JSON.stringify({ url: longUrl }),
});
const { short_url } = await res.json();

Python

import requests

r = requests.post(
    "https://eblocut.ru/api/shorten",
    headers={"Authorization": "Bearer <ВАШ_КЛЮЧ>"},
    json={"url": long_url},
)
print(r.json()["short_url"])

CORS

По умолчанию выключен — для интеграции сервер‑сервер он не нужен. Чтобы разрешить вызовы прямо из браузера другого сайта, владелец добавляет его домены в настройку EBLOCUT_CORS_ORIGINS. Учти: при вызове из браузера ключ будет виден в коде страницы.

API