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

Добро пожаловать в документацию по API! Наш API предоставляет доступ к информации о TON кошельках, связанных с ними аккаунтах Telegram, а также позволяет управлять API-ключами. Для работы с API требуется аутентификация с использованием API-ключа.

Базовый URL

Все запросы отправляются на базовый URL:

https://eyeton.ru/

Управление API ключами

Стоимость

1 запрос - 0.5 ⭐️

1 ⭐️ ~ $0,015

В запросе можно указывать до 100 telegramIDs (wallet)

Аутентификация

Для доступа к защищённым маршрутам необходимо передавать API-ключ в заголовке:

x-api-key: ваш_api_ключ

Поиск данных о кошельках

Поиск по критериям

GET /api/wallet-data/search

Ищет данные о кошельках по заданным критериям.

Заголовки:

X-API-Key: ваш API-ключ

Параметры запроса:

wallets (опционально): список TON кошельков, разделённых запятыми (до 100)
telegram_ids (опционально): список Telegram ID, разделённых запятыми (до 100)

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

GET /api/wallet-data/search?wallets=0:abc123,0:def456

GET /api/wallet-data/search?telegram_ids=96362584

Ответ (успех):

{ "data": [ { "wallet": "wallet", "result": [ { "wallet": "wallet", "telegram_id": "telegram_id", "ca": "ca", "token_name": "token_name", "token_ticker": "token_ticker", "dev_username": "dev_username", "dev_wallet": "dev_wallet", "dev_id": "dev_id", "is_scammer": boolean } ] } ], "remaining_balance": "remaining_balance" }

Ошибки

В случае ошибки API возвращает код состояния HTTP и объект JSON с подробной информацией.

Формат ответа ошибки:

{"error": "Описание ошибки"}

Возможные коды ошибок

400: Неверный запрос (например, отсутствуют обязательные параметры)
401: Неавторизован (неверный или отсутствующий API-ключ)
403: Доступ запрещён (недостаточно прав)
404: Ресурс не найден
500: Внутренняя ошибка сервера

Ограничения

Максимум 100 кошельков или Telegram ID за один запрос
Ограничение по балансу API-ключа: запросы снимают 0.5 единицы за каждый вызов