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

FastNear API

FastNear API — это индексированное REST-семейство для продуктовых представлений аккаунтов. Это самый быстрый способ ответить на вопросы вроде «чем владеет этот аккаунт?» или «какие аккаунты соответствуют этому публичному ключу?» без сборки результата из сырых RPC-вызовов.

Базовые URL​

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

FastNear API Mainnet
https://api.fastnear.com
FastNear API Testnet
https://test.api.fastnear.com

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

  • балансов кошельков и обзоров активов;
  • представлений аккаунта по NFT и FT-токенам;
  • поиска аккаунтов по публичному ключу;
  • объединённых снимков аккаунта для дашбордов, обозревателей и агентов.

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

  • Используйте Справочник RPC, когда нужны канонические методы JSON-RPC из протокола.
  • Используйте Транзакции API, когда основная задача — история транзакций или квитанций.
  • Используйте NEAR Data API, когда нужен опрос данных по блокам и проверка свежести.

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

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

Общие интерактивные примеры​

  • Используйте Copy example URL на любой интерактивной API-странице, чтобы поделиться выбранной сетью и заполненным состоянием запроса.
  • Общие URL примеров выполняются автоматически при загрузке, когда в них есть состояние операции.
  • Сохранённые API-ключи и токены никогда не включаются в такие общедоступные URL документации.

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

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

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

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

Мне нужно только одно низкоуровневое значение из состояния цепочки​

Используйте сырой RPC. Эта индексированная поверхность оптимизирована для продуктовых представлений, а не для дублирования каждого RPC-метода.

Страница всё ещё показывает данные mainnet​

Проверьте, поддерживает ли страница ?network=testnet. Некоторые сценарии работают только с mainnet, и документация явно отмечает такие случаи.

Мне нужны транзакции, а не балансы​

Переходите в Транзакции API, чтобы не перегружать поверхность представления аккаунта запросами по истории.