Как вызвать 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"}