Регистрация — Справочник API

Создание аккаунта до получения учетных данных: челлендж адреса, его проверка, создание аккаунта и чтение депозитного адреса до выпуска первого API-ключа.

Сгенерировано из openapi.yaml во время сборки. Базовый URL https://api.tenergy.me/v1 или https://api-nile.tenergy.me/v1 в сети Nile (Окружения). Каждый запрос ниже подписывается в соответствии с разделом Аутентификация, если в строке Аутентификация не указано иное.

Запрос челленджа для подписи адресом TRON

POST /v1/accounts/challenge · createAccountChallenge

Аутентификация: Публичный — учетные данные не требуются.

Шаг 1 модели регистрации и восстановления через челлендж адреса — единственной модели платформы: владение аккаунтом подтверждается подписью одноразового числа (nonce) адресом TRON вне нашей инфраструктуры. Мы никогда не видим приватные ключи, и здесь нечего перехватить фишингом — подпись подтверждает только контроль над адресом.

Возвращаемая строка message понятна человеку и привязана к домену (бренд, цель, nonce, срок действия), чтобы подписывающий в кошельке точно видел, на что соглашается. Подпишите её в формате личной подписи TIP-191; подпись должна восстанавливать исходный address.

Анонимный вызов, лимитируется по IP и адресу. Вызов для адреса, у которого уже есть аккаунт, ничем не отличается от вызова для нового адреса — эндпоинт намеренно не раскрывает факт существования аккаунта.

Тело запроса

JSON (AccountChallengeRequest), обязательно.

Пример тела запроса из контракта (значения для иллюстрации):

{"address":"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE","purpose":"signup"}

Ответы

Поля ответа (AccountChallenge)

Пример ответа 201 из контракта (значения для иллюстрации):

{
  "nonce": "9f2a7c1e4b6d8a0f3e5c7b9d1f3a5c7e",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "purpose": "signup",
  "message": "tenergy.me wants you to prove control of this address.\nPurpose: signup\nAddress: TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE\nNonce: 9f2a7c1e4b6d8a0f3e5c7b9d1f3a5c7e\nExpires: 2026-09-11T18:14:05.123Z\nSigning this creates no transaction and moves no funds.\n",
  "issued_at": "2026-09-11T18:04:05.123Z",
  "expires_at": "2026-09-11T18:14:05.123Z"
}

Проверка подписанного челленджа и получение bootstrap-токена

POST /v1/accounts/challenge/verify · verifyAccountChallenge

Аутентификация: Публичный — учетные данные не требуются.

Шаг 2. Проверяет, что signature восстанавливает address из текста сообщения челленджа message, и возвращает короткоживущий bootstrap-токен — учетные данные, сопровождающие пользователя на этапе от «нет аккаунта» до «первый API-ключ».

Bootstrap-токен передается в заголовке Authorization: Bearer abt_… и открывает ровно четыре операции: POST /v1/accounts, GET /v1/accounts/deposit-address, GET /v1/account и POST /v1/api-keys. Срок действия составляет 15 минут, привязан к одному аккаунту и не заменяет API-ключ.

Если у адреса уже есть аккаунт на этой платформе, возвращаются account_id и account_status — только вызвавшей стороне, подтвердившей подпись.

Nonce одноразовый. Повторный, истекший или неверно подписанный nonce возвращает единую ошибку 1010 challenge_invalid, чтобы ошибки не раскрывали информацию о существовании аккаунтов.

Тело запроса

JSON (AccountChallengeVerifyRequest), обязательно.

Пример тела запроса из контракта (значения для иллюстрации):

{
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "nonce": "9f2a7c1e4b6d8a0f3e5c7b9d1f3a5c7e",
  "signature": "1c3e5b7d9f1a3c5e7b9d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b7d9f1a3c5e7b9d1f3a5c7e9b1d3f5a7c9e1b3d5f7a9c1e3b5d7f9a1c3e5b"
}

Ответы

Поля ответа (BootstrapToken)

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "bootstrap_token": "abt_3f8c2d1e9b7a4c6e8f0a2b4d6e8f0a2b",
  "expires_at": "2026-09-11T18:19:05.123Z",
  "account_id": "acc_01J9Z4K2M7Q8",
  "account_status": "active"
}

Создание аккаунта

POST /v1/accounts · createAccount

Аутентификация: Bootstrap-токен или публичный.

Шаг 3. Создает аккаунт, принадлежащий подписавшему адресу, и возвращает его вместе с депозитным адресом. Аккаунт создается в статусе status: "unfunded": он существует, доступен для чтения, может принимать депозиты и выпускать API-ключи, но не может тратить средства до подтверждения пополнения.

Аутентифицируйтесь либо с помощью bootstrap-токена из POST /v1/accounts/challenge/verify, либо передав nonce + signature в теле запроса для создания в один вызов. Оба способа подтверждают одно и то же.

Идемпотентно по адресу. Если у адреса уже есть аккаунт на этой платформе, возвращается существующий аккаунт с кодом HTTP 200 без создания дубликата.

Поле email опционально и не проверяется здесь — это канал для восстановления и квитанций, привязываемый позже из панели управления. Вход по email-ссылке и Telegram — это дополнительные способы входа для людей в тот же аккаунт, а не отдельная модель регистрации.

API-ключи не ждут депозита (с 2026-09-26). Расходование средств блокируется балансом, а не отсутствием ключа: POST /v1/orders возвращает 4001 insufficient_funds, пока на балансе нет подтвержденных средств.

Тело запроса

JSON (AccountCreateRequest), обязательно.

Пример тела запроса из контракта (значения для иллюстрации):

{"address":"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"}

Ответы

Поля ответа (AccountCreated)

Депозитный адрес до создания первого API-ключа

GET /v1/accounts/deposit-address · getSignupDepositAddress

Аутентификация: Bootstrap-токен.

Адрес для пополнения, перевод на который переводит аккаунт в статус active и позволяет выпустить ключ. Доступен по bootstrap-токену, поэтому только что создавший аккаунт агент может сообщить адрес и минимум пользователю без сохранения долгосрочных ключей.

После создания ключа используйте GET /v1/deposit-addresses, возвращающий те же адреса.

Параметры

Ответы

Поля ответа

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "account_id": "acc_01J9Z4K2M7Q8",
  "status": "unfunded",
  "data": [
    {
      "currency": "TRX",
      "address": "TDepositAddressExample1111111111111",
      "memo": null,
      "confirmations_required": 19
    }
  ],
  "min_deposit_sun": 1000000
}