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

NEAR Data API

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

Базовые URL​

OpenAPI: JSON · YAML · все спецификации

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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