Здравствуйте, гость! | Регистрация |

корзина пуста

eng | rus

Resellers API

1. Общие положения

Внимание!


API не предназначен для перехвата удаляющихся доменов, введены ограничения на количество запросов, за нарушения будем банить.
Для автоматизированного перехвата доступен специальный интерфейс.

  • API доступен по HTTPS;
  • доступны тестовая и рабочая версии API по адресам https://demo-api.evonames.com и https://hiapi.evonames.com соответственно;
  • запросы шлются по адресу https://hiapi.evonames.com/apiCommand. Данные запроса передаются с помощью GET или POST переменных;
  • для авторизация используются перменные auth_login и auth_password;
  • результаты запроса возвращаются закодированными в JSON;
  • в случае ошибки в возвращенном массиве будет элемент с ключом "_error" содержащий описание ошибки;
  • допустимыми результатами запроса могут быть:
    • скаляр "true"
    • массив не содержащий элемент с ключом "_error" (в нём передаётся описание ошибки)
    • любой другой результат, в том числе пустой - это ошибка
Пример:
https://demo-api.evonames.com/domainsCheck?auth_login=demo&auth_password=demo&domains=test.com,adfwer234asdf.net

Пример полностью рабочий, можно скопировать URL в браузер и поиграться, посмотреть вывод ошибок.

2. Подробные примеры

В данной таблице приведена выдержка из справочника - полного списка всех доступных команд. На примере этих команд будет понятно как пользоваться справочником.

Команда: Описание: Аргументы:
domainsCheck Проверка доступности доменов
  • domains - domains, *
domainRegister Регистрация доменов
  • domain - domain, *
  • period - period, по умолчанию: 1 год
domainsRegister Domains registration
  • массив - domainRegister
domainGetInfo Get information of the domain
  • domain - domain
  • id - id
domainsGetInfo Get information of given domains
  • массив - domainGetInfo
domainSetNote Установка клиентского примечания для домена
  • domain - domain
  • note - label
  • id - id
domainsSetNote Set client note for given domains
  • массив - domainSetNote

2.1. domainsCheck

Единственный аргумент этой команды - "domains" - список доменнов через запятую для проверки их доступности для регистрации.
* - "звёздочка", значит что аргумент обязательный, если он не передан будет ошибка.

https://demo-api.evonames.com/domainsCheck?auth_login=demo&auth_password=demo&domains=test.com,adfwer234asdf.net

2.2. domainRegister

Обязательно указывать только имя домена, для остальных параметров предусмотрены дефолты.

https://demo-api.evonames.com/domainRegister?auth_login=demo&auth_password=demo&domain=test42345.com

2.3. domainsRegister

Пример bulk-операции - одновременно над несколькими объектами. В описании аргументов используется слово "массив" - обозначающее что должен передаваться массив каждый элемент которого подходит в качестве аргумента для указанной операции, в данном случае domainRegister.

https://demo-api.evonames.com/domainsRegister?auth_login=demo&auth_password=demo&0[domain]=test42345.com&1[domain]=test123123.net

2.4. domainGetInfo

Всё просто - надо передать имя или ID домена. Возвращает массив данных о домене.

https://demo-api.evonames.com/domainGetInfo?auth_login=demo&auth_password=demo&domain=test42345.com

2.5. domainsGetInfo

Bulk-операция - одновременно над несколькими объектами.

https://demo-api.evonames.com/domainsGetInfo?auth_login=demo&auth_password=demo&0[domain]=test42345.com&1[domain]=test.com

2.6. domainSetNote

Пустой или не преданный "note" - удаляет примечание.

https://demo-api.evonames.com/domainSetNote?auth_login=demo&auth_password=demo&domain=test.com&note=abc

2.7. domainsSetNote

https://demo-api.evonames.com/domainsSetNote?auth_login=demo&auth_password=demo&0[domain]=test.com&0[note]=abc&1[domain]=test3.com&1[note]=def

3. Справочник типов

Тип Описание
* Обязательное поле, значение должно быть непустое, не ноль, не пустая строка и не пустой список.
Поля без звёздочки - необязательны для заполнения, могут не передаваться при вызове команды.
id Айдишник. Целое число больше нуля.
Например: 314123
ids Список айдишников, через запятую, пробельные символы допускаются.
Например: 1234, 324534, 223423
domain Доменное имя
Например: domain.com
domains Список доменов, через запятую, пробельные символы допускаются.
Например: domain.com, asdf.net
ns Имя NS'а (name server'а).
Например: ns1.domain.com
nss Список NS'ов, через запятую, пробельные символы допускаются.
Например: ns1.domain.com, ns2.domain.com
eid Extended ID - расширенный айдишник. Допускаются цифры, латинские буквы и символы: '_.:-' (подчерк, точка, двоеточие, минус).
Например: EID_234234:234-1
password Максимальная длина 64 символа. Не должен содержать символов переноса строки: \n, \r.
Например: We\p!Jie6w
period Целое число от 1 до 10. Используется для указания количества лет при регистрации и продлении.
Например: 1
date
expires		 Дата в ISO формате.
Например: 2012-09-25
ref Идентификатор. Состоит только из цифр, латинских букв и подчерка. Ограничений на первый символ нет.
Например: ok
Например: 7days
Например: 0001
refs Список идентификаторов, через запятую, пробельные символы допускаются.
Например: ok, nok, 123
label Строка почти без ограничений. Не допускаются символы переноса строки.
Например: Это имя клиента - Ivan Drago
labels Список строк, через запятую, пробельные символы допускаются. Допускается передача массивом.
Например: Ваня, Петя, Федя, John
dnsName Пустая строка, "*", "@" либо строка не длиннее 100 символов, состоящая из не более чем 4 частей, разделенных ".", каждая из которых состоит из 1-61 символов следующих типов: латинские символы, цифры и знаки "-" и "_" (при этом "-" не может быть первым или последним символом).
Например: *, @, n1, a1.b2, a1.b2.c3, a1.b2.c3.d4

4. Справочник команд

Команда Описание Аргументы
domainsCheck Проверка доступности доменов
  • domains - domains, *
domainsSearch List/Search domains
  • ids - ids
  • domain - label
  • domains - labels
  • note - labels
  • state - ref
  • client - labels
  • seller - labels
  • orderby - ref
  • limit - id
  • total - id
  • page - id
  • count - bool
  • show_dns - bool
  • show_fw_park - bool
  • dns - ref
  • view - ref
domainRegister Регистрация доменов
  • domain - domain, *
  • period - period - по умолчанию: 1 год
  • registrant - eid
  • admin - eid
  • tech - eid
  • billing - eid
domainsRegister Register domains
  • массив - domainRegister
domainTransfer Start domain transfer
  • domain - domain, *
  • password - password, *
domainsTransfer Start domains transfer
  • массив - domainTransfer
domainGetNSs Get name servers of the domain
  • domain - domain
  • id - id
domainsGetNSs Get name servers of domains
  • массив - domainGetNSs
domainSetNSs Установка NS'ов для домена
  • domain - domain
  • nss - nss
  • id - id
domainsSetNSs Set name servers for given domains
  • массив - domainSetNSs
domainGetNote Get domain note
  • domain - domain
  • id - id
domainsGetNote Get domains note
  • массив - domainGetNote
domainSetNote Установка клиентского примечания для домена
  • domain - domain
  • note - label
  • id - id
domainsSetNote Set client note for given domains
  • массив - domainSetNote
domainRenew Domain renew
  • domain - domain, *
  • period - period, *
  • expires - expires, * - current expiration date
domainGetPassword Get domain password
  • domain - domain
  • pincode - pincode
  • id - id
domainsGetPassword Get domains password
  • массив - domainGetPassword
domainRegenPassword Domain regen password
  • domain - domain
  • pincode - pincode
  • id - id
domainsRegenPassword Domains regen password
  • массив - domainRegenPassword
domainGetInfo Get information of the domain
  • domain - domain
  • id - id
domainsGetInfo Get information of given domains
  • массив - domainGetInfo
domainGetContacts Get contacts of the domain
  • domain - domain
  • id - id
domainGetWPContacts Get WHOIS protected contacts of the domain
  • domain - domain
  • id - id
domainGetContactsInfo Get contacts info of the domain
  • такие же как - domainGetContacts
domainGetWPContactsInfo Get WHOIS protected contacts info of the domain
  • такие же как - domainGetContactsInfo
domainsGetContacts Get contacts of given domains
  • массив - domainGetContacts
domainsGetWPContacts Get WHOIS protected contacts of given domains
  • массив - domainGetContacts
domainsGetContactsInfo Get contacts info of given domains
  • массив - domainGetContacts
domainsGetWPContactsInfo Get WHOIS protected contacts info of given domains
  • массив - domainGetContacts
domainSetContacts Set domain contacts
  • domain - domain
  • id - id
  • registrant - eid, *
  • admin - eid, *
  • tech - eid, *
  • billing - eid, *
domainsSetContacts Set contacts for given domains
  • массив - domainSetContacts
domainEnableAutorenewal Enable autorenewal for the domain
  • domain - domain
  • id - id
domainDisableAutorenewal Disable autorenewal for the domain
  • такие же как - domainEnableAutorenewal
domainsEnableAutorenewal Enable autorenewal for given domains
  • массив - domainEnableAutorenewal
domainsDisableAutorenewal Disable autorenewal for given domains
  • массив - domainEnableAutorenewal
domainEnableWhoisProtect Enable whois protect for the domain
  • domain - domain
  • id - id
domainDisableWhoisProtect Enable whois protect for the domain
  • такие же как - domainEnableWhoisProtect
domainsEnableWhoisProtect Enable whois protect for given domains
  • массив - domainEnableWhoisProtect
domainsDisableWhoisProtect Disable whois protect for given domains
  • массив - domainEnableWhoisProtect
domainEnableLock Enable lock for the domain
  • domain - domain
  • id - id
domainDisableLock Disable lock for the domain
  • такие же как - domainEnableLock
domainsEnableLock Enable lock for given domains
  • массив - domainEnableLock
domainsDisableLock Disable lock for given domains
  • массив - domainEnableLock
domainGetDNS Get DNS settings for given domain
  • id - id
  • domain - domain
domainsGetDNS Get DNS settings for given domains
  • массив - domainGetDNS
domainSetDNS Set DNS settings for given domain
  • массив {
    • name - dnsName
    • type - ref
    • value - label
    • no - id
    • ttl - id
    • status - ref (ok,deleted)
    }
domainsSetDNS Set DNS settings for given domains
  • массив - domainSetDNS
hostsSearch Hosts search
  • ids - ids
  • host - labels
  • domain - labels
  • domain_ids - ids
  • note - labels
  • client - labels
  • seller - labels
  • orderby - ref
  • limit - id
  • total - id
  • page - id
  • count - bool
hostGetInfo Host get info
  • id - id
  • host - ns
hostsGetInfo Hosts get info
  • массив - hostGetInfo
hostCreate Host create
  • host - ns, *
  • ips - ips
hostsCreate Hosts create
  • массив - hostCreate
hostUpdate Host update
  • id - id
  • host - ns
  • ips - ips
hostsUpdate Hosts update
  • массив - hostUpdate
contactsSearch List/Search contacts
  • ids - ids
  • name - labels
  • email - labels
  • client - labels
  • seller - labels
  • select - ref
  • orderby - ref
  • limit - id
  • total - id
  • page - id
  • count - bool
contactGetInfo Get contact info
  • id - eid, *
contactsGetInfo Get contacts info
  • массив - contactGetInfo
contactCreate Создать контакт
  • first_name - label, *
  • last_name - label
  • email - email, *
  • birth_date - date
  • emails - emails
  • organization - label
  • street1 - label, *
  • street2 - label
  • street3 - label
  • city - label, *
  • province - label
  • postal_code - label, *
  • country - ref, *
  • voice_phone - phone, *
  • fax_phone - phone
  • type - ref - один из: person, organization
  • passport_no - label
  • passport_date - label
  • passport_by - label
  • organization_ru - label - for .ru zone only
  • inn - label - for .ru zone only
  • kpp - label - for .ru zone only
  • director_name - label - for .ru zone only
  • isresident - boolean - for .ru zone only
contactsCreate Create contacts
  • массив - contactCreate
contactUpdate Update contact
  • id - id,*
  • pincode - pincode
  • first_name - label, *
  • last_name - label
  • email - email, *
  • birth_date - date
  • emails - emails
  • organization - label
  • street1 - label, *
  • street2 - label
  • street3 - label
  • city - label, *
  • province - label
  • postal_code - label, *
  • country - ref, *
  • voice_phone - phone, *
  • fax_phone - phone
  • passport_no - label
  • passport_date - label
  • passport_by - label
  • organization_ru - label
  • inn - label
  • kpp - label
  • director_name - label
  • isresident - boolean
contactsUpdate Update contacts
  • массив - contactUpdate
clientGetBalance Получить баланс клиента
  • id - id
  • client - client
  • currency - ref
clientGetPrices Get client prices
  • client - client
  • id - id
  • seller - client
  • seller_id - id
clientsGetPrices Get clients prices
  • массив - clientGetPrices