Как вызвать 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 |
from | string(42) | 40-значный Ether-адрес с префиксом "0x..." | 0xe4eeae4ebdd5e44ca4c27043dda859da841a97e |
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) | (URL-encoded) Ссылка, на которую будет отправлено IPN-оповещение | https://yourdomain.com/handler.php?a=1&b=c |
tag | string(1000) | Метка, которая будет передана в IPN | op112233 |
uniqID | string | Уникальная метка (см. описание в конкретном методе) | usr321 |
lifetime | int | Максимальное время отслеживания в минутах | 30 |
Пример
Пример вызова:
https://etherapi.net/api/v2/.balance?key=7f11318c57-d80ec82a73-8ae56f31cc-a9c336253b&token=OMG
Ответ в случае успеха:
{"result":0}
Ответ в случае ошибки:
{"error":"token_wrong"}