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

KV FastData API

KV FastData API — это семейство только для чтения данных «ключ-значение». Оно лучше всего работает, когда вы уже знаете аккаунт, вызывающий аккаунт или шаблон ключей, которые хотите проверить, и хотите получить эти строки без собственной индексации хранилища.

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

  • истории данных «ключ-значение», ориентированной на вызывающий аккаунт;
  • запросов к данным «ключ-значение», ориентированных на аккаунт;
  • точного поиска по ключу или по префиксу;
  • пакетных сценариев поиска для отладки и агентных бэкендов.

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

  • Используйте FastNear API для более высокоуровневых представлений аккаунта, токенов и NFT.
  • Используйте NEAR Data API для чтения по блокам вместо истории данных «ключ-значение».

Базовые URL​

  • https://kv.main.fastnear.com
  • https://kv.test.fastnear.com

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

  • Эти встраиваемые страницы не передают API-ключи и токены Bearer.
  • Добавьте ?network=testnet, чтобы переключить страницу на testnet-бэкенд там, где это поддерживается.
  • В ответах со списками поле page_token отсутствует, когда новых результатов больше нет.

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

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

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

Токен пагинации перестал работать​

Считайте значения page_token непрозрачными и повторно используйте их только с тем же эндпоинтом и теми же фильтрами.

Мне нужны продуктовые балансы аккаунта, а не сырые строки «ключ-значение»​

Переходите на FastNear API.