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

API переводов

API переводов — это самая узкая поверхность истории FastNear. Стартуйте здесь, когда вопрос именно о движении активов, а не о более широкой истории исполнения за этим движением.

Базовый URL​

Transfers API Mainnet
https://transfers.main.fastnear.com

Эта поверхность сейчас доступна только в mainnet. ?network=testnet не переключает бэкенд.

Используйте этот API, когда​

  • нужна история переводов NEAR или FT-токенов по аккаунту
  • строятся ленты кошелька или представления активности только по переводам
  • отвечаете на вопросы поддержки или комплаенса про отправку и получение

Не стартуйте здесь, когда​

  • нужна более широкая история транзакций или квитанций
  • нужны балансы, активы, NFT или представления стейкинга
  • нужен трафик testnet

Используйте Транзакции API для более широкой истории исполнения и FastNear API для ответов в стиле состояния аккаунта.

Минимально полезные входы​

  • account_id
  • опциональные фильтры: актив, направление, сумма или время
  • нужно пользователю несколько событий или более длинный обзор истории

Рабочий цикл по умолчанию​

  1. Начните с Запроса переводов, используя самый узкий набор фильтров, который всё ещё отвечает на вопрос.
  2. Читайте возвращённые события как историю только переводов. Не пересобирайте полную хронологию квитанций, пока пользователь не попросит.
  3. Переиспользуйте непрозрачный resume_token ровно в том виде, в каком его вернул сервис, при листании дальше.
  4. Остановитесь, как только можете ответить, кто, что, когда и в каком активе отправил.

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

  • Публичные чтения истории переводов часто работают и без ключа.
  • Если вы стандартизируете один FastNear API-ключ на всех поверхностях FastNear, используйте здесь тот же формат через заголовок или параметр запроса.
  • Ответы включают непрозрачный resume_token для пагинации.
  • Сервис сейчас доступен только в mainnet.

Расширяйтесь, только если​

  • пользователь начинает спрашивать о квитанциях или действиях кроме переводов
  • пользователь хочет более широкий контекст транзакции за переводом
  • пользователь на самом деле спрашивает о балансах или текущих активах, а не о движении

Тогда расширяйтесь на Транзакции API или FastNear API, а не перегружайте представление переводов.

Типовые стартовые страницы​

  • Запрос переводов — лента по аккаунту с фильтрами по направлению, активу, сумме и времени

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

Используйте Transfers API Examples для простых пошаговых сценариев: узкие поиски переводов, пагинация через resume_token и переход к более широкому расследованию транзакций.

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

Нужны полные метаданные транзакции​

Переходите на Транзакции API, если одной истории переводов недостаточно.

resume_token перестал работать​

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