Список всех контроллеров / kzdomain / contact-update

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

Назначение:
Редактирование существующего контакта в базе регистратуры доменных имен .KZ
Поля запроса:
name desc
handle Уникальный индитификатор редактируемого контакта.
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.
Элемент может быть пустым, если операция по изменению ни разу не производилась.
Пример:
Запрос:
https://api.ps.kz/kzdomain/contact-update?username=test&password=test
&input_format=http&output_format=json
&handle=PS-KZ-000-000997
&email=nod%40test.kz
&name=Nod
&org=%D0%9A%D0%BE%D1%80%D0%BF%D0%BE%D1%80%D0%B0%D1%86%D0%B8%D1%8F+%D0%BC%D0%BE%D0%BD%D1%81%D1%82%D1%80%D0%BE%D0%B2
&pc=050000
&cc=KZ
&sp=Almaty+obl.
&city=Almaty
&street=Ploshad%27+Respubliki+15
&voice=7%28000%290000000

Ответ:
Формат возвращаемого ответа можно задать через параметр output_format=json|xml|array
{
  "result" : "success",
  "answer" : {
    "handle" : "PS-KZ-000-000997",
    "name" : "Nod",
    "org" : "Korporaciya monstrov",
    "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"
    },
    "update" : {
      "id" : "ICPS",
      "utc" : "2011-12-09T16:54:42Z",
      "unix" : "1323449682"
    }
  }
}
Возможные ошибки:
Ошибки при выполнении запроса:
Данные ошибки выводятся в корне ответа.
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. Переданный параметр имеет неверный формат, значение или отсутствует.
OBJECT_NOT_FOUND Object does not found in ps.kz database. See error_data for details about problem object. Объект не найден в базе ps.kz. См. параметр error_data для детальной информации о проблемном объекте.
OBJECT_NOT_BELONGS_TO_YOU Object does not belongs to you. See error_data for details. Объект не пренадлежит вам. См. параметр error_data для детальной информации.

blog comments powered by Disqus