Q-URL API Documentation

Overview

Q-URL предоставляет простой RESTful API для сокращения URL-адресов и проверки информации о сокращенных ссылках. API доступен для всех разработчиков и не требует аутентификации для базового использования.

1. Сокращение URL

https://url.qwerez.com/api/shorten

Запрос

Отправьте POST запрос с JSON объектом, содержащим URL для сокращения:

{
  "url": "https://example.com"
}

Ответ

{
  "shortUrl": "https://url.qwerez.com/r/abc123",
  "originalUrl": "https://example.com"
}

Пример CURL

curl -X POST https://url.qwerez.com/api/shorten \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

2. Проверка URL

https://url.qwerez.com/api/check/{code}

Запрос

Отправьте GET запрос, указав код сокращенной ссылки в URL. Код может быть как полной ссылкой (например, https://url.qwerez.com/r/abc123), так и просто кодом (abc123).

Ответ

{
  "shortUrl": "https://url.qwerez.com/r/abc123",
  "originalUrl": "https://example.com"
}

Пример CURL

curl https://url.qwerez.com/api/check/abc123

Ограничения

Максимальная длина исходного URL: 2048 символов
Rate limit: 100 запросов в час с одного IP
Поддерживаются только валидные HTTP/HTTPS URL

Коды ответов

200 OK

Запрос выполнен успешно

400 Bad Request

Невалидный URL или отсутствующие параметры

404 Not Found

Сокращенная ссылка не найдена

429 Too Many Requests

Превышен лимит запросов

500 Internal Server Error

Внутренняя ошибка сервера