API для сокращения URL-адресов

API для сокращения URL-адресов — часто задаваемые вопросы

Является ли API сервиса сокращения URL-адресов бесплатным в использовании?

Да. Бесплатный тариф Linkly включает 500 переходов по ссылкам в месяц и один собственный домен, а также доступ к API для работы со ссылками, аналитики и веб-хуков. API аналитики позволяет отправлять 100 запросов в месяц в бесплатном тарифе (1000 в платных тарифах). Для регистрации не требуется кредитная карта.

Linkly — это не только API для сокращения URL-адресов, но и API для сокращения ссылок?

Да — «API для сокращения ссылок» и «API для сокращения URL-адресов» — это одно и то же, и Linkly является и тем, и другим. Одни и те же REST-интерфейсы позволяют сокращать любые URL-адреса, прикреплять собственный домен с фирменной символикой, отслеживать каждый клик и отправлять POST-запросы через веб-хуки, поэтому вы можете использовать Linkly везде, где вам необходимо программное сокращение ссылок.

Как аутентифицировать запросы к API?

Сгенерируйте ключ API в разделе «Настройки» → «Ключи API» в Linkly, затем передавайте его в качестве параметра запроса api_key в каждом запросе (например, https://api.linklyhq.com/api/v1/link?api_key=YOUR_API_KEY). Включите ваш workspace_id в тело запроса. Ключи API можно менять в любое время.

Каков лимит запросов к API?

Конечные точки для создания ссылок допускают до 100 запросов в секунду на одно рабочее пространство. API аналитики ограничен 50 запросами в час на одно рабочее пространство. В случае превышения лимита API возвращает HTTP-код 429 с указанием текущего использования и лимита в теле ответа.

Можно ли создавать фирменные короткие ссылки через API?

Да. Подключите собственный домен к своему аккаунту Linkly (одноразовый шаг DNS) и передайте его в качестве поля domain в теле запроса API (например, "domain": "yourbrand.com"). Каждая ссылка, созданная через API, будет использовать ваш фирменный домен — например, yourbrand.com/summer-sale вместо l.linklyhq.com/abc.

Предоставляет ли Linkly веб-хуки для событий клика?

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

Существует ли спецификация OpenAPI?

Да. Linkly публикует спецификацию OpenAPI 3.0, которую можно импортировать в Postman, Insomnia и большинство генераторов API-клиентов. Спецификация остается синхронизированной с продакшеном — нет смещения версий.

Что произойдет, если я превышу лимит кликов, установленный моим тарифным планом?

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

Как мне обрабатывать большие объемы SMS-сообщений — скажем, 10 миллионов ссылок в месяц?

Конечные точки для массового создания принимают множество URL-адресов за один запрос, а выделенная инфраструктура Cloudflare на периферии обрабатывает кампании с большим объемом трафика. План Unlimited покрывает крупные рассылки по единой фиксированной ежемесячной ставке с действительно неограниченным количеством кликов — никаких расчетов объема и звонков от отдела продаж, просто зарегистрируйтесь и пользуйтесь.

Каков уровень доступности сервиса Linkly (SLA)?

99,9% измерено на пути перенаправления (критическая поверхность). На странице состояния на status.linklyhq.com отображается историческое время безотказной работы. Тарифный план Unlimited включает в себя договорное соглашение об уровне обслуживания (SLA) с предоставлением скидок за обслуживание.

Поддерживает ли API обработку данных в соответствии с GDPR?

Да. Linkly по умолчанию соответствует требованиям GDPR, а размещение данных в ЕС доступно в корпоративных тарифных планах. Для всех платных клиентов доступно дополнительное соглашение об обработке данных. Полезные нагрузки веб-хуков можно настроить таким образом, чтобы исключить персональные данные для более строгих требований соответствия.