Войти

API сервиса сокращения ссылок

Обратите внимание, что API сервиса сейчас находится в тестовом режиме, поэтому могут возникнуть некоторые проблемы в его работе.

Для использования API и добавления ссылок в ваш личный кабинет, вам потребуется ваш уникальный ключ API, который можно найти в вашем профиле на сайте. При передаче ссылок через API необходимо включить этот ключ, указав его в параметре "key", а также передать длинную ссылку в параметре "url". В ответ вы получите короткую ссылку, которая автоматически добавится в ваш личный кабинет.


Пример запроса:
https://3le.ru/api/?key=ваш_api_key&url=длинная_ссылка&callback=ваш_колбек

Не забудьте также указать параметр "callback", который опционален, но может быть полезен для обработки ответа сервера при необходимости.


Перед отправкой ссылки через API сервиса, убедитесь, что она предварительно обработана. Если вы используете PHP, используйте функцию rawurlencode(), а для JavaScript (в том числе с помощью jQuery) - encodeURIComponent(), чтобы избежать потери критически важных параметров или искажения ссылки.


Примеры обработки ссылки:
Для JSrawurlencode(\'https://yoursolongurl.com\')
для jQueryencodeURIComponent(\'https://yoursolongurl.com\')

Обратите внимание, что если длинная ссылка уже была сокращена кем-то ранее, статистика по ней будет доступна только этому пользователю. Вы получите только короткую ссылку без возможности просмотра статистики или добавления в ваш профиль.


ТЕСТ (нажмите для демонстрации)
Отправляемый запрос:https://3le.ru/api/?key=3LE&url=https://rawme.ru/&callback=

Ответ:
Короткая ссылка:
Отправленные данные:
Отправленный ключ API:
Отправленная ссылка:
В данном примере сервис получает три параметра: KEY, URL и CALLBACK

Параметр key = 3LE это ключ API который вы можете взять в личном кабинете.
а url = https://rawme.ru/ - ссылка которую необходимо укоротить.


Пример использования API:

Кнопка, по нажатию на которую отправляется текущий URL страницы и возвращается короткая ссылка.Если нажать на полученную короткую ссылку, она копируется в буфер обмена с выводом сообщения.
Устанавливаем DIV и стилизуем:<div id="short_me" data-key="3LE"></div>   
Подключаем библиотеку jQuery:<script src="https://3le.ru/assets/js/jquery-3.7.1.min.js"></script>
Подключаем скрипт кнопки:<script src="https://3le.ru/assets/js/short_btn.js"></script>

В целях повышения безопасности посетителей и повышения прозрачности работы сервиса, добавлены опции отображающие полный путь ссылки, куда ожидается переход, для нормальных ссылок и ссылок помеченных как подозрительные. Помимо отображения полного пути ссылки, на самой странице перехода, добавлены следующие опции для вебмастеров и сервисов проверяющие безопасность ссылок.

При открытии страницы перехода с таймером передается header заголовок вида:

x-full-url: полный адрес ссылки, куда будет перемещение

так же дополнительно передается в теге meta метаданных о полной ссылке:
<meta http-equiv="FullURL" content="полный адрес ссылки, куда будет перемещение">

Для ссылок закрытых паролем и с прямым переходом - данные опции недоступны, так как теряется смысл данного функционала и такие ссылки модерируется с особой тщательностью.

© 2024 3le.ru | Cокращение длинных ссылок О проекте API Помощь Правила сервиса СПАМ политика Контакты Сделано с в России. | Поддержать