Перейти к основному содержимому

NEAR Data API

NEAR Data API — это поверхность для чтения данных почти в реальном времени, а также по семействам блоков. Используйте её, когда нужны свежие срезы блоков, вспомогательные маршруты с перенаправлением или недавние финализированные и оптимистичные чтения, но без позиционирования продукта как потокового сервиса.

Базовые URL​

NEAR Data API Mainnet
https://mainnet.neardata.xyz
NEAR Data API Testnet
https://testnet.neardata.xyz

Лучше всего подходит для​

  • опроса недавних финализированных и оптимистичных блоков;
  • вспомогательных маршрутов по блокам и сценариев с перенаправлением;
  • лёгких проверок свежести данных и мониторинга.

Когда его не стоит использовать​

  • Используйте Справочник RPC для канонических методов JSON-RPC и отправки транзакций.
  • Используйте Снапшоты для поднятия инфраструктуры, а не для чтения живых данных.

Аутентификация и доступность​

  • Тот же FastNear API-ключ работает и здесь; на публичном трафике на поддерживаемых маршрутах по-прежнему можно использовать необязательный параметр запроса apiKey.
  • Неверный API-ключ возвращает 401 ещё до того, как сработают вспомогательные перенаправления, поэтому при отладке с неверным ключом канонический URL не будет виден.
  • Добавьте ?network=testnet, чтобы переключить совместимые страницы на значения по умолчанию для testnet.

С чего обычно начинают​

Нужен сценарий?​

Используйте примеры NEAR Data API для простых пошаговых сценариев: опроса оптимистичных блоков, подтверждения финализированных блоков, работы с перенаправлениями и перехода к каноническому RPC.

Устранение неполадок​

Некоторые эндпоинты перенаправляют на канонический URL вместо прямого возврата результата​

Это ожидаемое поведение для вспомогательных маршрутов с перенаправлением. Если клиенту нужен итоговый ресурс, переходите по канонической цели.

Ответ по блоку равен null​

Обычно это означает, что запрошенной высоты нет в этой сети или запрос вышел за ожидаемый диапазон свежести либо архива.

Нужна потоковая передача, а не опрос​

Эта поверхность предназначена для чтения через опрос почти в реальном времени. Не позиционируйте её как продукт на основе WebSocket или вебхуков.