Логотип Zagl

Документация API

Сокращайте ссылки прямо из кода. Один эндпоинт, один bearer-токен.

Эндпоинт

POSThttps://za.gl/api/shorten
RESTТело JSONBearer-авторизация

Авторизация

Передайте свой API-токен в заголовке Authorization как bearer-токен. Возьмите его в панели аккаунта после того, как создадите первую ссылку.

Заголовок
Authorization: Bearer YOUR_API_TOKEN

Токена ещё нет? Эндпоинт можно вызвать и без него. Za.gl на лету создаст анонимный аккаунт и вернёт новый токен в поле data.newAuthToken. Сохраните его, чтобы потом управлять своими ссылками.

Тело запроса

originalUrlобязательно

string

Длинная ссылка, которую нужно сократить. Если протокол не указан, https:// подставится сам.

customAlias

string

Своё окончание, например za.gl/my-link. Должно быть уникальным, иначе вернётся 409.

password

string

Закрывает ссылку паролем: без него посетитель дальше не пройдёт.

expiresAt

string (ISO date)

Когда ссылка перестанет работать. Дата должна быть в будущем.

expiresInMinutes / expiresInHours / expiresInDays

number

Замена expiresAt: срок отсчитывается от момента создания.

waitTimer

number (0-300)

Сколько секунд посетитель ждёт на странице предпросмотра до перехода.

customGtmId

string

Ваш собственный ID Google Tag Manager (GTM-XXXXXXX), срабатывает на странице предпросмотра.

title / description

string

Необязательные метаданные, они хранятся вместе со ссылкой.

generateQR

boolean

Дополнительно вернуть QR для короткой ссылки.

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

POSTcURL
curl -X POST https://za.gl/api/shorten \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "password": "optional-secret",
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "waitTimer": 5
  }'

Пример ответа

Успешный вызов возвращает 200 OK с короткой ссылкой в поле data.shortUrl.

200 OKJSON
{
  "success": true,
  "message": "URL shortened successfully",
  "data": {
    "id": "123",
    "alias": "my-link",
    "shortUrl": "https://za.gl/my-link",
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "domain": "za.gl",
    "title": "",
    "description": null,
    "hasPassword": true,
    "isActive": true,
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "hits": 0,
    "waitTimer": 5,
    "created": "2026-06-25T10:00:00.000Z",
    "modified": "2026-06-25T10:00:00.000Z",
    "authToken": "your-account-token"
  }
}

Лимиты и ошибки

10 req/minДо 10 запросов в минуту на клиента.
409Такое окончание уже занято.
400Неверная ссылка или дата окончания в прошлом.
429Превышен лимит запросов или месячная квота.