Управление операциями

Просмотр, фильтрация и управление транзакциями

Фильтры

ID Тип Сумма User ID Получатель Сервис Статус Ref ID TX Hash Создано Действия
Загрузка данных...

Документация API

Полное руководство по использованию TON Transaction API

Базовая информация

Base URL: http://127.0.0.1:8000

Content-Type: application/json

Версия API: v1

Создание транзакций

POST /v1/buy

Создает одну или несколько транзакций. Транзакции из одного запроса группируются и выполняются вместе одной пачкой.

Параметры запроса

Параметр Тип Описание
transactions array Массив транзакций (макс. 50 за запрос)
kind string Тип транзакции: stars, premium, ton
amount integer Сумма (для stars/ton) или количество месяцев (для premium)
user_id integer ID пользователя в Telegram
receiver string Username получателя (без @)
service string Название сервиса

Пример: Одна транзакция

curl -X POST http://127.0.0.1:8000/v1/buy \
  -H "Content-Type: application/json" \
  -d '{
        "transactions": [
          {
            "kind": "stars",
            "amount": 100,
            "user_id": 1107170408,
            "receiver": "h04x4",
            "service": "frontman"
          }
        ]
      }'

Пример: Несколько транзакций (пакетная обработка)

curl -X POST http://127.0.0.1:8000/v1/buy \
  -H "Content-Type: application/json" \
  -d '{
        "transactions": [
          {
            "kind": "stars",
            "amount": 50,
            "user_id": 1107170408,
            "receiver": "h04x4",
            "service": "frontman"
          },
          {
            "kind": "stars",
            "amount": 50,
            "user_id": 1107170408,
            "receiver": "h04x4",
            "service": "frontman"
          },
          {
            "kind": "premium",
            "amount": 1,
            "user_id": 1107170408,
            "receiver": "username",
            "service": "frontman"
          }
        ]
      }'

Ответ (201 Created)

{
  "operations": [
    {
      "id": 1,
      "status": "pending"
    },
    {
      "id": 2,
      "status": "pending"
    }
  ],
  "message": "Successfully created 2 operations"
}

Получение всех операций

GET /operations/all

Возвращает список всех операций с подробной информацией.

Пример запроса

curl -X GET http://127.0.0.1:8000/operations/all

Удаление операций

POST /operations/delete

Удаляет операции по их ID.

Пример запроса

curl -X POST http://127.0.0.1:8000/operations/delete \
  -H "Content-Type: application/json" \
  -d '{
        "ids": [1, 2, 3]
      }'

Health Check

GET /health

Проверка статуса API.

Пример запроса

curl -X GET http://127.0.0.1:8000/health

Статусы операций

pending

Операция создана и ожидает обработки

sent

Транзакция отправлена в блокчейн

success

Транзакция успешно завершена

error

Произошла ошибка при обработке

Важные замечания

  • Максимум 50 транзакций за один запрос
  • Транзакции из одного запроса группируются и выполняются вместе одной пачкой
  • Каждый запрос получает уникальный request_id для группировки
  • Операции обрабатываются автоматически фоновым процессом
  • После завершения транзакции отправляется webhook (если настроен)
  • Webhook отправляется на URL, указанный в конфигурации для соответствующего сервиса