Ошибки BlockTrail

Ошибки BlockTrail

В BlockTrail API возвращает стандартный код ответа http и сообщения, содержащие более подробные сведения об ошибке.

200: все работало как положено
400: неверный запрос - происходит, когда вы пропустили обязательный параметр.
401: недопустимые учетные данные - либо API_KEY не верна или http-подпись двиг не
403: отказано в разрешении - у вас нет необходимых разрешений для выполнения запроса
404: отсутствует конечная точка или объект не найден
429: слишком много запросов - количество запросов за последние 60 секунд было слишком много
50*: ошибка сервера - что-то пошло не так на BlockTrail стороне запросу
В случае ошибки в теле ответа будет в запрашиваемом формате и содержать сообщение об ошибке 'код' и 'сообщение'.

Ошибки в SDK

Пакет SDK будет разбирать ошибки и следить за "нормальное" поведение для языка в обработке ошибок.
В большинстве случаев это будет бросать исключение, кроме nodeJS, где первый параметр обратного вызова-это всегда ошибка.

завиток
Питон
В PHP
в jQuery
Узел.яш
$ curl "https://api.blocktrail.com/v1/btc/address/1NcXPMRaanz43b1kokpPuYDdk6GGDvxT2T?api_key=BAD_APIKEY"
Адрес

Для получения конкретного адреса, содержащие основную информацию, такую как текущий баланс, общая сумма, которую получили, и количество сделок.

Аргументы

адрес (строка) Биткоин-адрес хэш
Возвращаемое Значение

адрес (строка) Биткоин-адрес хэш
hash160 (строка) В Hash160 Биткоин адрес.
баланс (целое число) Тот подтвердил, балансе-адрес, отображаемый в Сатоши.
получил (целое число) Общая подтвержденная сумма полученных адресов, отображается в Сатоши.
отправил (целое число) Общая подтвержденная сумма отправленных по адресу, отображается в Сатоши.
unconfirmed_received (целое число) Текущая неподтвержденные суммы, направляемые на адрес, отображается в Сатоши.
unconfirmed_sent (целое число) Текущая неподтвержденные суммы, полученные по адресу, отображается в Сатоши
unconfirmed_transactions (целое число) Общее количество неподтвержденных сделок по адрес (полученные и отправленные).
total_transactions_in (целое число) Общее количество подтвержденных сделок поступивших в адрес
total_transactions_out (целое число) Общее количество подтвержденных транзакций, отправленных с адреса
Категория (строка) Категории присваиваются на этот адрес через анализ Blocktrail в сети.
тег (строка) Тег, присвоенный данному адресу путем анализа Blocktrail в сети.
завиток
Питон
В PHP
в jQuery
Узел.яш
$ curl "https://api.blocktrail.com/v1/btc/address/1NcXPMRaanz43b1kokpPuYDdk6GGDvxT2T?api_key=MY_APIKEY"
Возвращаемое Значение
{
"address": "1NcXPMRaanz43b1kokpPuYDdk6GGDvxT2T",
"hash160": "ED12908714FFD43142BF9832692017E8AD54E9A8",
"balance": 49497392,
"received": 115015000,
"sent": 65517608,
"unconfirmed_received": 0,
"unconfirmed_sent": 0,
"unconfirmed_transactions": 0,
"total_transactions_in": 4,
"total_transactions_out": 10,
"category": "donations",
"tag": "blocktrail"
}
Адресные Сделки

Возвращает список разбивается на страницы всех сделок (подтвержденные и неподтвержденные), касающихся конкретного адреса.

Аргументы

адрес (строка) Биткоин-адрес хэш
страницы (число) (необязательный) Страницы пагинации для получения
предел (число) (необязательный) количество возвращаемых записей на странице (максимум 200)
sort_dir (строка) (необязательный) направление сортировки результатов ('ASC' или 'деск')
Возвращаемое Значение

current_page (целое число) пагинация: текущая страница записей
per_page (целое число) пагинация: количество записей, возвращаемых на страницу
общая (целое число) пагинация: общее число найденных записей
данные (массив) Массив пронумерованных записей, имеющих следующие свойства:
хэш (строка) Хэш транзакции
время (строка) Отметки времени UTC (в формате iso8601 Формат), когда сделка была последней, распространяемой по сети и видел BlockTrail.
подтверждений (целое число) Общее число блоков, которые были обработаны с транзакции, включая блок, содержащий сделки. Неподтвержденная транзакция будет иметь 0 подтверждений.
block_height (целое число) Высота блока, содержащего сделки. Высота-это расстояние от первого блока в цепочке, начиная с высоты = 0. Неподтвержденная транзакция будет иметь нулевую высоту.
block_hash (строка) Хэш-блок, содержащий сделки. Неподтвержденная транзакция будет иметь значение NULL block_hash.
is_coinbase (булево) Указывает на то, что транзакция-это транзакция blockchain кошелек, созданный Шахтер, который добывается блок, содержащий сделки.
estimated_value (целое число) Общая сметная стоимость сделки на Сатоши, рассчитывается как сумма всех значений выходной минус расчетная сумма изменится.
total_input_value (целое число) Общая стоимость всех входов в Сатоши.
total_output_value (целое число) Общая стоимость всех мероприятий в Сатоши.
total_fee (целое число) Общая сумма вознаграждения, выплаченная в шахтерском в Сатоши.
estimated_change (целое число) Общая сметная изменения для этой сделки в Сатоши.
estimated_change_address (строка) Расчетная изменить адрес для данной операции.
входы (массив) Массив всех данных, используемых в транзакции, в качестве объектов со следующими свойствами:
индекс (целое число) Положение входного массива входов (ноль проиндексированных).
output_hash (строка) Хэш транзакции, содержащей Выходные данные, используемые для создания этого ввода. Это NULL для операций фонда.
output_index (целое число) Позиции выходного массива выходов для проводки, из которого вход был создан.
значение (целое число) Стоимость ввода в Сатоши.
адрес (строка) Адрес, с которого вклад был внесен.
Тип (строка) Тип входных данных - будут "последние" в случае сделок фонда.
multisig (строка) Тип мульти-подписи (например, "1of2")
script_signature (строка) Подпись скрипт, используемый для разблокировки ввода для использования в сделке. Это NULL для операций фонда.
выходы (массив) Массив всех мероприятий, вытекающих из сделки, учитывая как объекты со следующими свойствами:
индекс (целое число) Позиции выходного массива выходов (ноль проиндексированных).
значение (целое число) Значение выхода в Сатоши.
адрес (строка) Адрес получения выходного значения.
Тип (строка) Тип вывода (например, pubkeyhash).
multisig (строка) Тип мульти-подписи (например, "1of2")
multisig_addresses (массив) Список адресов, участвующих в мультиподписи транзакций
сценарий (строка) Сценарий выходного.
script_hex (строка) Скрипт вывода в шестнадцатеричном виде.
spent_hash (строка) Хэш транзакции, в которой этот вывод впоследствии были потрачены. Имеет значение NULL для неизрасходованные выходы.
spent_index (целое число) Положение этого вывода в массиве входных данных для транзакций, которые впоследствии тратит на этот выход.
завиток
Питон
В PHP
в jQuery
Узел.яш
$ curl "https://api.blocktrail.com/v1/btc/address/1NcXPMRaanz43b1kokpPuYDdk6GGDvxT2T/transactions?api_key=MY_APIKEY"
Возвращаемое Значение
{
"data": [
{
"hash": "8fa29a1db30aceed2ec5afb2bcdf6196207975780b4ca5f3f1d6313cab855fe7",
"time": "2014-08-25T09:29:28+0000",
"confirmations": 3743,
"is_coinbase": false,
"estimated_value": 25000000,
"total_input_value": 105139900,
"total_output_value": 105129900,
"total_fee": 10000,
"estimated_change": 80129900,
"estimated_change_address": "1qMBuZnrmGoAc2MWyTnSgoLuWReDHNYyF",
"inputs": [
{
"index": 0,
"output_hash": "b0fc639ef699e8521dd4863fc9b8f6224d8aafb3e4fe52bb784150973c711523",
"output_index": 1,
"value": 105139900,
"address": "1qMBuZnrmGoAc2MWyTnSgoLuWReDHNYyF",
"type": "pubkeyhash",
"multisig": null,
"script_signature": "0x48 0x3045022100b7dcc897c7baadf693865818ea1fa7c544073936cad37f27fa402cb517989f7002201c56fb93e3acb3c016d394765f0a248cb85fa6ae290336fef88ca811dd6d6d0f01 0x41 0x04bc6b933acf9ff99e9c2946ecfe927a3813e0218bcfa58f3b5107a956a307055faa2609b879e51dda158820f93c8a22d12abfaa46c99d43e3ecc4c497c27fec5b"
}
],
"outputs": [
{
"index": 0,
"value": 25000000,
"address": "1NcXPMRaanz43b1kokpPuYDdk6GGDvxT2T",
"type": "pubkeyhash",
"multisig": null,
"script": "DUP HASH160 0x14 0xed12908714ffd43142bf9832692017e8ad54e9a8 EQUALVERIFY CHECKSIG",
"script_hex": "76a914ed12908714ffd43142bf9832692017e8ad54e9a888ac",
"spent_hash": "489495ed713a924edd7526af30d8c8d7926df692794a7cb71feab36e3f9c70f7",
"spent_index": 0
},
{
"index": 1,
"value": 80129900,
"address": "1qMBuZnrmGoAc2MWyTnSgoLuWReDHNYyF",
"type": "pubkeyhash",
"multisig": null,
"script": "DUP HASH160 0x14 0x0924d17ba19064a0d4bdfbdc983764ef5b4ee81a EQUALVERIFY CHECKSIG",
"script_hex": "76a9140924d17ba19064a0d4bdfbdc983764ef5b4ee81a88ac",
"spent_hash": "496e5ebf630a40aca780c0f7f55d0a5afc44a2c1375b55a86e5dd7773207f321",
"spent_index": 0
}
]
},
{ /* ... */ }
],
"current_page": 1,
"per_page": 20,
"total": 14
}
Адрес Неподтвержденные Транзакции

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

Аргументы

адрес (строка) Биткоин-адрес хэш
страницы (число) (необязательный) Страницы пагинации для получения
предел (число) (необязательный) количество возвращаемых записей на странице (по умолчанию 20, максимум 200)
sort_dir (строка) (необязательный) направление сортировки результатов ('ASC' или 'деск')
Возвращаемое Значение

current_page (целое число) пагинация: текущая страница записей
per_page (целое число) пагинация: количество записей, возвращаемых на страницу
общая (целое число) пагинация: общее число найденных записей
данные (массив) Массив пронумерованных записей, имеющих следующие свойства:
хэш (строка) Хэш транзакции
время (строка) Отметки времени UTC (в формате iso8601 Формат), когда сделка была последней, распространяемой по сети и видел BlockTrail.
подтверждений (целое число) Всегда будет 0 при получении неподтвержденные транзакции.
is_coinbase (булево) Указывает на то, что транзакция-это транзакция blockchain кошелек, созданный Шахтер, который добывается блок, содержащий сделки.
estimated_value (целое число) Общая сметная стоимость сделки на Сатоши, рассчитывается как сумма всех значений выходной минус расчетная сумма изменится.
total_input_value (целое число) Общая стоимость всех входов в Сатоши.
total_output_value (целое число) Общая стоимость всех мероприятий в Сатоши.