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

NEAR Data API

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

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

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

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

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

Базовые URL​

  • https://mainnet.neardata.xyz
  • https://testnet.neardata.xyz

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

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

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

  • Оптимистичный блок — для самого свежего опроса блоков.
  • Финализированный блок по высоте и Заголовки блока — для запросов по финализированным блокам.
  • Перенаправление на последний финализированный блок и Перенаправление на последний оптимистичный блок — когда вам нужны вспомогательные маршруты с перенаправлением.

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

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

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

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

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

Мне нужен стриминг, а не опрос​

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