# API/Интеграция
# API
API Enecuum доступен на Swagger.
Инструкцию по созданию кошелька в Enecuum можно найти во введении. Инструкции по отправке транзакций и генерации подписей доступны в методе POST /tx.
ОСТОРОЖНО
ENQ имеет хэш токена/идентификатор/тикер транзакции 0000000000000000000000000000000000000000000000000000000000000000. Ненулевые значения означают, что вы имеете дело с активом, отличным от Enecuum. Пользовательские токены имеют случайную шестнадцатеричную строку в качестве идентификатора токена.
ОСТОРОЖНО
Отклоненные транзакции записываются в блокчейн. Используйте GET /tx, чтобы проверить статус транзакции.
Имейте в виду, что любой кошелек, в том числе созданный для технических целей, может получать реферальные вознаграждения. Это может произойти, если кто-то решит использовать реферальный адрес кошелька в качестве своего реферального агента. Эти награды стмечены в блокчейне соответствующим образом.
Чтобы получить объяснение ответов на запросы, перейдите к схемам ответов. Вы можете получить к ним доступ, выбрав «Schema» рядом с «Example Value».
# Порядок транзакций
Блокчейн Enecuum состоит из макроблоков. Каждый макроблок содержит ключевой блок (kblock), микроблоки (mblock), статблоки (sblock). Хэши микроблоков лексикографически отсортированы в шестнадцатеричном формате. Микроблоки содержат транзакции, которые также лексикографически отсортированы по шестнадцатеричному хешу.
# Интеграция пользовательских токенов
В некоторых методах API необходимо указывать идентификатор токена. Для ENQ идентификатор токена - это нули. Если идентификатор токена представляет собой случайную шестнадцатеричную строку, это означает, что это пользовательский токен.
Чтобы отправлять транзакции с пользовательскими токенами, используйте POST /tx с указанным идентификатором токена.
Для проверки баланса используйте метод GET /balance с указанным идентификатором токена.
Чтобы узнать комиссию за пользовательский токен, эмиссию и другие параметры, используйте GET /token_info с указанным идентификатором токена. Комиссии за пользовательские токены описаны в руководстве Принцип работы комиссии.
# Получение последних транзаций
Чтобы лучше понять структуру блокчейна Enecuum, попробуйте этот пример. Получить список последних транзакций можно следующим образом:
- Используйте GET /height, чтобы получить номер последнего блока.
- Используйте GET /macroblock_by_height с номером предыдущего блока в качестве параметра. Вы получите содержимое этого блока: keyblock, microblock, statblock. Только микроблоки содержат транзакции.
- Используйте GET /mblock с хешем микроблока в качестве параметра. Вы получите список транзакций этого микроблока.