Использование сервиса в автоматическом режиме

Для упрощения процедуры переноса домена, мы предлагаем хостинг-провайдерам для увеличения прихода клиентов воспользоваться нашим сервисом в автоматическом режиме. Доступ осуществляется по протоколу HTTPS запросами POST, ответы выдаются в формате JSON. Сервис платный - плата взымается за один уникальный пакет документов в сутки. Т.е. не важно сколько раз клиент попросил документы на список доменов - плата будет взыматься один раз. Плата взымается по окончанию календарного месяца. Стоимость одного пакета документов 30 рублей. Первые две недели - бесплатно.

По вопросам подключения обращаться в нашу службу поддержки support@diphost.ru


Использование условно бесплатного сервиса в автоматическом режиме

Возможно также использование сервиса "как есть" в автоматическом режиме. Для этого при запросах по API используйте значение параметра code равное free


Использование сервиса с частично заполненной формой

Сервис предоставляет бесплатную возможность заполнить форму на стороне хостинг-провайдера. Для этого, следует создать форму с полями, описанными ниже в разделе API, исключая поля type и code, с дополнительным полем edit со значением 1. В этом случае будет выдана страница сервиса с заполненными полями. Запрос пакета документов пользователь будет выполнять уже на нашем сервисе. Важно помнить, что кодировка формы должны быть строго UTF-8.


API

Запросы осуществляются по протоколу HTTP/1.1 методом POST по защищенному каналу SSL. Обязательным параметром является параметр code, который имеет значение секретного кода, выдаваемого при подключении. Кодировка запросов - строго UTF-8. Кириллические домены в зонах .SU и .РФ в ответе будут переведены в нормальный декодированный вид и в верхний регистр. Существует два вида запросов - для проверки доменов, и для генерации документов. Рекомендуем делать запрос для проверки - это оградит от очевидных вычисляемых техническим путём ошибок.


API. Запрос для проверки.

Хост запроса "chreg.ru", порт 443, URL запроса "/".

Параметры (все обязательны):

  • code - защитный ключ, идентифицирующий партнёра, значение даётся при подключении
  • type - тип запроса, имеет пока одно значение json, указание обязательно
  • domains - список доменов через пробел или перевод строки "\n", максимальное количество - 20 доменов


# Пример запроса на языке Python

import urllib,httplib,sys

domains=("cctld.ru","test.ru")
headers = {"Content-type": "application/x-www-form-urlencoded", "Accept": "text/plain"}
params = urllib.urlencode({'domains': ' '.join(domains), 'type':'json', 'code':'вашкод'})
try:
	conn = httplib.HTTPSConnection("chreg.ru",443,timeout=10)
	conn.request("POST", "/", params, headers)
	res = conn.getresponse()
	result="{}"
	if (res.status==200) or (res.status==400) or (res.status==403) or (res.status==503):
		result = res.read()
	print result
except:
	print("whois connection error %s" % sys.exc_value)


Ответы могут быть с кодами HTTP:

  • 503 - при превышении количества запросов в минуту или при переполненности сервера
  • 403 - при ошибке доступа, например, неверном пароле
  • 400 - при ошибке в переданных данных
  • 200 - в случае полностью положительного ответа

Тело ответа в формате JSON будет содержать словарь со следующими ключами:
  • domains - массив словарей с данными по доменам которые смог определить, по словарю на домен со следующими элементами:
    • name - имя домена в верхнем регистре (если домен был кириллическим, то в нормализованном виде)
    • who - наименование владельца домена
    • email - контактный email владельца домена если есть
    • whois - полный ответ сервиса whois для домена
    • registrar - массив данных регистратора домена из следующих элементов: [наименование регистратора, идентификатор в реестре регистратора, сайт регистратора, поддерживает или нет по нашим сведениям регистратор смену администратора домена - "0" или "1"]
  • admintype - строка "org" или "person", если удалось определить тип владельца для доменов
  • zone - строка "RU", или "XN--P1AI" (РФ,) или "SU", если удалось определить единую зону для доменов
  • errors - массив массивов с ошибками, массив каждого элемента в массиве errors состоит из 4 элементов: [Внутренний сквозной код ошибки, тип элемента в котором произошла ошибка, значение этого элемента (пара используется для уточнения места происхождения ошибки), сообщение об ошибке на английском языке]


API. Запрос пакета документов.

Хост запроса "chreg.ru", порт 443, URL запроса "/get".

Основные параметры (обязательные кроме chadmin):

  • code - защитный ключ, идентифицирующий партнёра, значение даётся при подключении
  • type - тип запроса, имеет пока одно значение json, указание обязательно
  • to - идентификатор в реестре регистратора, к которому переносим домены (например "REGISTRATOR-REG-RIPN"), список идентификаторов можно найти на странице списка регистраторов
  • domain - домен, если доменов много - параметр повторяется, максимальное количество - 20 доменов
  • chadmin - строка "org" или "person", необязательный параметр, указывает, что требуется смена администратора домена на организацию или физическое лицо


Все последующие параметры заполняются так, как они указаны в документах. Кодировка - строго UTF8. Максимальная длина поля - 50 символов. Значения параметров совпадают с подобными в форме на странице сервиса, можно сначала посмотреть на них для понимания.


Если домены принадлежат физическому лицу, то требуется передать следующие параметры владельца домена:

  • firstname - имя в родительном падеже
  • family - фамилия в родительном падеже
  • fathername - отчество в родительном падеже
  • ifirstname - имя в творительном падеже (заполняется, если домен будет менять владельца)
  • ifamily - фамилия в творительном падеже (заполняется, если домен будет менять владельца)
  • ifathername - отчество в творительном падеже (заполняется, если домен будет менять владельца)
  • zipcode - почтовый индекс места постоянной регистрации
  • country - страна места постоянной регистрации
  • city - город места постоянной регистрации
  • address - адрес места постоянной регистрации (все 4 поля можно опустить, но будьте готовы к придиркам)
  • serial - серия паспорта
  • number - номер паспорта
  • whoget - кем выдан паспорт
  • gday - число выдачи паспорта (1-31)
  • gmonth - месяц выдачи паспорта (1-12)
  • gyear - год выдачи паспорта
  • bdday - число рождения (1-31)
  • bdmonth - месяц рождения (1-12)
  • bdyear - год рождения

Если домены принадлежат юридическому лицу, то требуется передать следующие параметры владельца домена:
  • rorg - название организации
  • inn - ИНН организации
  • kpp - КПП организации
  • chief - должность руководителя организации в родительном падеже
  • reason - на основании чего действует руководитель организации в родительном падеже
  • fio - фамилия и инициалы руководителя организации
  • chiefs - должность руководителя организации в именительном падеже
  • firstname - имя в родительном падеже
  • family - фамилия в родительном падеже
  • fathername - отчество в родительном падеже
  • zipcode - почтовый индекс почтового адреса
  • country - страна почтового адреса
  • city - город почтового адреса
  • address - адрес почтового адреса

Если домены после переноса передаются физическому лицу, то требуется передать следующие параметры нового владельца домена (если домен остаётся у прежнего владельца, и поле chadmin не заполнено, то параметры заполнять не требуется):
  • firstname2 - имя в родительном падеже
  • family2 - фамилия в родительном падеже
  • fathername2 - отчество в родительном падеже
  • dfirstname2 - имя в дательном падеже
  • dfamily2 - фамилия в дательном падеже
  • dfathername2 - отчество в дательном падеже
  • zipcode2 - почтовый индекс места постоянной регистрации
  • country2 - страна места постоянной регистрации
  • city2 - город места постоянной регистрации
  • address2 - адрес места постоянной регистрации (все 4 поля о регистрации можно опустить, но будьте готовы к придиркам)
  • serial2 - серия паспорта
  • number2 - номер паспорта
  • whoget2 - кем выдан паспорт
  • gday2 - число выдачи паспорта (1-31)
  • gmonth2 - месяц выдачи паспорта (1-12)
  • gyear2 - год выдачи паспорта
  • bdday2 - число рождения (1-31)
  • bdmonth2 - месяц рождения (1-12)
  • bdyear2 - год рождения
  • anketa2 - номер договора, на котором будет размещён домен (обязательное поле)
  • partner2 - номер договора партнёра, под управлением которого размещена анкета (если такового нет - поле опустить)

Если домены после переноса передаются юридическому лицу, то требуется передать следующие параметры нового владельца домена. (если домен остаётся у прежнего владельца, и поле chadmin не заполнено, то параметры заполнять не требуется):
  • rorg2 - название организации
  • inn2 - ИНН организации
  • kpp2 - КПП организации
  • chief2 - должность руководителя организации в родительном падеже
  • reason2 - на основании чего действует руководитель организации в родительном падеже
  • fio2 - фамилия и инициалы руководителя организации
  • chiefs2 - должность руководителя организации в именительном падеже
  • firstname2 - имя в родительном падеже
  • family2 - фамилия в родительном падеже
  • fathername2 - отчество в родительном падеже
  • zipcode2 - почтовый индекс почтового адреса
  • country2 - страна почтового адреса
  • city2 - город почтового адреса
  • address2 - адрес почтового адреса
  • anketa2 - номер договора, на котором будет размещён домен (обязательное поле)
  • partner2 - номер договора партнёра, под управлением которого размещена анкета (если такового нет - поле опустить)


Ответ сервиса абсолютно такой же как и в случае запроса проверки, только при ответе с HTTP-кодом 200 в теле ответа будет предложен файл в формате pdf содержащий пакет документов на перенос требуемых доменов.