NEAR Data API

NEAR Data API — это поверхность для недавних блоков и шардов. Используйте её, когда нужны свежие срезы блоков, мониторинг активности контракта, вспомогательные маршруты с перенаправлением или сравнение оптимистичных и финализированных чтений без превращения продукта в потоковый 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 для практических примеров: обнаружения активности контракта, сравнения оптимистичных и финализированных наблюдений, а также проверки изменений на уровне шарда.

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

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

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

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

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

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

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