Выберите подходящую поверхность FastNear

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

Канонический JSON-RPCRPCИспользуйте канонические методы JSON-RPC для чтения данных напрямую из протокола, отправки транзакций и проверки состояния сети.Лучше всего подходит для:

• состояния аккаунта
• поиска блоков
• вызовов view-методов контракта
• данных валидаторов

Индексированные балансыFastNear APIНачните здесь, если вам нужны удобные для кошельков балансы, NFT, стейкинг и поиск по публичному ключу без сырых JSON-RPC-обёрток.Лучше всего подходит для:

• полного снимка аккаунта
• балансов FT-токенов
• активов NFT
• поиска по публичному ключу

История транзакцийТранзакции APIЗапрашивайте историю транзакций по аккаунту, квитанции, блоку или хешу, когда нужен индексированный API истории вместо опроса узлов.Лучше всего подходит для:

• активности аккаунта
• поиска транзакций
• трассировки квитанций
• истории транзакций по блоку

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

• снапшотов mainnet
• снапшотов testnet
• обзора сценариев работы со снапшотами

Повышенные лимитыАутентификация и доступПосмотрите, как API-ключи FastNear работают в интерфейсе документации и как перейти от демо-сценариев к безопасному серверному использованию.Лучше всего подходит для:

• обзора аутентификации
• браузерного демо-сценария
• аутентификации продакшен-бэкенда

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

• оптимистичных чтений блоков
• последнего финализированного блока
• опроса заголовков блоков

Перед интеграцией

Вот детали, которые технические команды обычно хотят понять заранее:

• Аутентификация и доступ: разберитесь в различии между встроенным демо-сценарием документации и аутентификацией продакшен-бэкенда.
• FastNear Dashboard: управляйте API-ключами и переходите на сценарии с более высокими лимитами.
• Статус FastNear: проверяйте инциденты и деградацию сервиса до отладки поведения приложения.
• Справочник RPC: выбирайте между обычным и архивным RPC в зависимости от объёма нужной вам истории цепочки.
• Снапшоты: поднимайте инфраструктуру быстрее, если разворачиваете RPC- или архивные узлы.

Практические рекомендации по выбору поверхности

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

Другие семейства API

Эти дополнительные API остаются полезными и после знакомства с основными поверхностями выше:

• FastNear API: Индексированные представления аккаунтов для балансов, NFT, стейкинга и поиска по публичному ключу.
• Транзакции API: История по аккаунтам, блокам, квитанциям и транзакциям на основе индексированных данных исполнения.
• API переводов: Специализированная история переводов для активности аккаунта и интерфейсов с глубокой пагинацией.
• KV FastData API: Индексированная история данных «ключ-значение» и поиск последнего состояния для анализа хранилища контракта.
• NEAR Data API: Недавние чтения финализированных и оптимистичных блоков для сценариев опроса с низкой задержкой.

Если вы создаёте решение для AI или агентов

• Начните со страницы Как выбрать подходящую поверхность, чтобы сопоставить задачу с правильной поверхностью FastNear.
• Используйте Аутентификацию для агентов, когда вызывающая сторона — это сервис автоматизации, воркер или среда выполнения агента.
• Берите за основу Плейбуки для агентов, если нужен конкретный шаблон рабочего процесса.
• Используйте Аутентификацию и доступ, чтобы хранить учётные данные агентов на серверной стороне.
• Используйте действие страницы Копировать Markdown, чтобы переносить чистый контекст документации в промпты, заметки и среды выполнения агентов.