Как вызвать API

Описание параметров, пример, лимиты

Для вызова любого API сервиса отправьте GET-запрос на адрес https://etherapi.net/api/v2 с указанием обязательных параметров key и method. Можно указывать метод непосредственно в адресе, например:
https://etherapi.net/api/v2/.balance?key=..
равнозначно
https://etherapi.net/api/v2?method=balance&key=..
Набор остальных параметров зависит от вызываемого метода. Звездочкой (*) будут отмечены необязательные параметры.

Параметр Тип Описание Пример
method string(7) Метод: give, track, balance, send или status send
key string(43) Ключ доступа к API 7f11318c57-d80ec82a73-8ae56f31cc-a9c336253b
address string(42) 40-значный Ether-адрес с префиксом "0x..." 0xa122eae4ebdd5e44ca4c27043dda859da841b09c
token string(10) ID токена из списка GNT
amount float Количество (сумма) Ether-монет. Десятичное число с максимальной точностью 6 знаков после запятой 1.234567
price float Цена газа в Gwei. Чем выше цена, тем быстрее подтверждается транзакция 3.2
limit int Лимит газа. Максимальное количество газа, доступное для выполнения транзакции 50000
statusURL string(500) Ссылка, на которую будет отправлено IPN-оповещение https://yourdomain.com/handler.php?a=1&b=c
tag string(1000) Метка, которая будет передана в IPN op112233
uniqID string Уникальная метка (см. описание в конкретном методе) usr321
Сервис вернет ответ в формате JSON. В случае успеха результат выполнения вызова находится в поле result. В противном случае код ошибки будет в поле error.

Пример

Пример вызова:
https://etherapi.net/api/v2/.balance?key=7f11318c57-d80ec82a73-8ae56f31cc-a9c336253b&token=OMG

Ответ в случае успеха:
{"result":0}

Ответ в случае ошибки:
{"error":"token_wrong"}

Лимиты

С целью ограничения нагрузки на сервер существует лимит на частоту обращения к API - не более 3х раз в секунду