Функция kzdomain/contact-create

Назначение:

Создать контакт в базе регистратуры доменных имен .KZ

Поля запроса:

name	desc
email	E-mail
voice	Контактный телефон. Разрешены цифры, точка, пробелы и скобки. Длина от 5 до 20 символов.
voiceext	Контактный телефон, добавочный номер (необязательное поле)
fax	Номер факса (необязательное поле). Разрешены цифры, точка, пробелы и скобки. Длина от 5 до 20 символов.
faxext	Номер факса, добавочный номер (необязательное поле)
name	Имя Фамилия, БИН. До 128 символов.
org	Название организации, БИН (необязательное поле для физических лиц). До 128 символов.
street	Адрес. До 128 символов.
city	Город. До 128 символов.
sp	Область. До 64 символов.
pc	Почтовый индекс.
cc	Код страны. Две латинские буквы.

Поля ответа:

name	desc
handle	Уникальный индитификатор. В доменах используется для полей registrant_handle и admin_handle
name	Фамилия Имя, ИИН
org	Название организации, БИН
street	Улица
city	Город
sp	Область
pc	Почтовый индекс
cc	Двухбуквенный код страны
voice	Контактный телефон
voiceext	Добавочный номер к телефону
fax	Факс
faxext	Добавочный номер к факсу
email	E-mail
registrar	Регистратор, который сейчас обслуживает текущий контакт
create	Информация о создании контакта. Состоит из элементов: id - имя регистратора, который производил операцию. utc - дата в формате RFC3339, время по гринвичу. unix - время в формате unix-time.
update	Информация об изменении контакта. Состоит из элементов: id - имя регистратора, который производил операцию. utc - дата в формате RFC3339, время по гринвичу. unix - время в формате unix-time. Элемент может быть пустым, если операция по изменению ни разу не производилась.

Пример:

Запрос:

GET JSON XML

https://api.ps.kz/kzdomain/contact-create?username=test&password=test
&input_format=http&output_format=json
&email=nod%40test.kz
&name=Nikita+Krasulin%2C+123456789000
&org=PS+Internet+Company+LLC%2C+080840007694
&pc=050000
&cc=KZ
&sp=Almaty+obl.
&city=Almaty
&street=Ploshad%27+Respubliki+15
&voice=7%28000%290000000

https://api.ps.kz/kzdomain/contact-create?username=test&password=test
&input_format=json&output_format=json
&input_data=

{
  "email" : "nod@test.kz",
  "name" : "Nikita Krasulin, 123456789000",
  "org" : "PS Internet Company LLC, 080840007694",
  "pc" : "050000",
  "cc" : "KZ",
  "sp" : "Almaty obl.",
  "city" : "Almaty",
  "street" : "Ploshad' Respubliki 15",
  "voice" : "7(000)0000000"
}

https://api.ps.kz/kzdomain/contact-create?username=test&password=test
&input_format=xml&output_format=json
&input_data=

<data>
   <email>nod@test.kz</email>
   <name>Nikita Krasulin, 123456789000</name>
   <org>PS Internet Company LLC, 080840007694</org>
   <pc>050000</pc>
   <cc>KZ</cc>
   <sp>Almaty obl.</sp>
   <city>Almaty</city>
   <street>Ploshad' Respubliki 15</street>
   <voice>7(000)0000000</voice>
</data>

Ответ:
Формат возвращаемого ответа можно задать через параметр output_format=json|xml|array

{
  "result" : "success",
  "answer" : {
    "handle" : "PS-KZ-000-000997",
    "name" : "Nikita Krasulin, 123456789000",
    "org" : "PS Internet Company LLC, 080840007694",
    "street" : "Ploshad' Respubliki 15",
    "city" : "Almaty",
    "sp" : "Almaty obl.",
    "pc" : "050000",
    "cc" : "KZ",
    "voice" : "7(000)0000000",
    "voiceext" : "",
    "faxext" : "",
    "email" : "nod@test.kz",
    "registrar" : "ICPS",
    "create" : {
      "id" : "ICPS",
      "utc" : "2011-12-09T16:01:10Z",
      "unix" : "1323446470"
    }
  }
}

Пример:

Запрос:

GET JSON XML

https://api.ps.kz/kzdomain/contact-create?username=test&password=test
&input_format=http&output_format=json
&email=wrong%40mail

https://api.ps.kz/kzdomain/contact-create?username=test&password=test
&input_format=json&output_format=json
&input_data=

{
  "email" : "wrong@mail"
}

https://api.ps.kz/kzdomain/contact-create?username=test&password=test
&input_format=xml&output_format=json
&input_data=

<data>
   <email>wrong@mail</email>
</data>

Ответ:
Формат возвращаемого ответа можно задать через параметр output_format=json|xml|array

{
  "result" : "error",
  "error_text" : "Given parameter has an invalid format or value.",
  "error_code" : "PARAMETER_INCORRECT",
  "error_data" : {
    "required_fields" : [
      "name",
      "pc",
      "cc",
      "sp",
      "city",
      "street",
      "voice"
    ],
    "incorrect_value" : [
      "email"
    ]
  }
}

Возможные ошибки:

Ошибки при выполнении запроса:
Данные ошибки выводятся в корне ответа.

Error_code	Error_text	Описание
DOMAIN_CONNECTION_FAILED	Unable to establish connection with the registry of domain names. Try again later.	Невозможно установить соединение с регистратурой доменных имён. Попробуйте повторить попытку позднее.
PARAMETER_INCORRECT	Given parameter has an invalid format or value or is missing.	Переданный параметр имеет неверный формат, значение или отсутствует.