REST JSON API для статистики, отзывов, рейтингов и телефонов

Данные, лежащие в основе Astrina — аналитика сайтов, отзывы, сводки по рейтингам и информация о телефонных номерах — теперь доступны для того, чтобы получать их прямо в вашем коде. Developer API — это REST JSON API, который отдаёт всё это по единственному ключу.

Один ключ, четыре эндпоинта

API версионируется под /api/v1, и каждый эндпоинт говорит на чистом JSON. Направьте свой клиент на нужный ресурс:

• GET /api/v1/stats — аналитика по сайту, которым вы владеете: посетители, просмотры страниц, топовые страницы, источники и страны.
• GET /api/v1/reviews — отзывы вместе с рейтингом объекта.
• GET /api/v1/rating — сводка по рейтингу с распределением звёзд.
• GET /api/v1/phone — информация о телефонных номерах.

Помимо этого, Auth API обеспечивает работу «Входа через Astrina», так что вы можете добавить социальный вход в собственное приложение, не выстраивая систему идентификации самостоятельно.

Аутентификация так, как удобно вашему стеку

Получите ключ на /my/api.php, а затем отправляйте его тем способом, который удобнее всего вашему клиенту. API принимает три формы:

• Заголовок X-Api-Key.
• Токен Authorization: Bearer.
• Параметр запроса ?api_key=.

Аутентификация через заголовок — самый безопасный вариант по умолчанию для серверного кода; параметр запроса удобен для быстрых тестов и вызовов на стороне браузера. Ответы открыты для CORS, так что при необходимости вы можете вызывать API напрямую из фронтенда, и они помечены как noindex, чтобы ваши данные не попали в поисковые системы.

Квоты и тарифы

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

• Бесплатный тариф: 100 вызовов в день.
• Тариф API: 10 000 вызовов в день за €19 за 30 дней.
• Тариф бизнес-аналитики: доступ к API включён.

Начните с бесплатного тарифа для прототипирования, а затем переходите выше, когда вашей интеграции понадобится запас.

Предсказуемый JSON, предсказуемые ошибки

И успех, и сбой возвращаются в виде JSON. Когда что-то идёт не так, в ответе есть поле error и правильный HTTP-статус, так что ваша обработка ошибок может ветвиться по коду статуса, а не разбирать строки:

• 401 — неверный ключ.
• 429 — квота превышена.
• 400 / 422 — неверные параметры.

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

Как начать

1. Откройте /my/api.php и создайте ключ API.
2. Выберите эндпоинт — начните с /api/v1/stats для сайта, которым вы владеете.
3. Отправьте ключ в заголовке X-Api-Key и считайте JSON в ответ.

Первый вызов — это одна строка:

curl -H "X-Api-Key: YOUR_KEY" https://astrina.io/api/v1/stats

Предпочитаете bearer-токен? Замените заголовок:

curl -H "Authorization: Bearer YOUR_KEY" https://astrina.io/api/v1/reviews

Или вставьте ключ прямо в URL для быстрой проверки:

curl "https://astrina.io/api/v1/rating?api_key=YOUR_KEY"

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