--------------------------------------------------------------
 Спецификация KazNIC API v1 (Информация о новых регистрациях)
--------------------------------------------------------------

API v1 предоствляет слудющие функции:

1) Авторизация
2) Смена пароля
3) Получить список последних зарегистрированных доменов
4) Получить список доменов по идентификатору(id) блока
5) Получить список доменов за указанную дату

----------
 ОПИСАНИЕ
----------

Все запросы производятся на указанный url с типом запросов GET и POST.

Все данные в запросах к серверу и ответы от сервера передаются в формате JSON.

Чтобы работать с KazNIC API v1 на первом этапе необходимо пройти авторизацию и 
получить токен(jwt token). Полученный токен необходимо передавать в заголовках к 
каждому запросу API. Пример заголоква с токеном: "Authorization: Bearer jwt_token".


1) Авторизация

url: https://api.nic.kz/auth/signin
http request type: POST

json request:
{
	"username" : "admin",
	"password" : "12345678"
}

json success response:
{
	"response" : {
		"result_code" : "0",
		"result_msg" : "Success"
	},
	"response_data" : {
		"token" : "jwt token"
	}
}

json failed response:
{
	"response" : {
		"result_code" : "2",
		"result_msg" : "Access denited, password expired"
	}
}

Возвращаемые коды:

result_code : "0" , result_msg : "Success"
result_code : "2" , result_msg : "Access denited, password expired"

Если пользователь не найден или введене не верные или не полные авторизационные 
данные(пользователь, пароль), то возвращается  http response: 403 

Токен является валидным в течении 15 минут, после получения.


2) Смена пароля

Процедурой смены пароля нужно воспользоваться в случае истечения срока валидности пароля.
Новый пароль является валидным в течении 90 суток.

url: https://api.nic.kz/auth/changepassword
http request type: POST

json request:
{
	"username" : "user",
	"old_password" : "pass1",
	"new_password" : "pass2"
}


json success response:
{
	"response" : {
		"result_code" : "0",
		"result_msg" : "Success"
	}
}

json failed response:
{
	"response" : {
		"result_code" : "4",
		"result_msg" : "Wrong new password, password length must be 8-50 symbols"
	}
}

Возвращаемые коды:

result_code : "0" , result_msg : "Success"
result_code : "4" , result_msg : "Wrong new password, password length must be 8-50 symbols"

Если пользователь не найден или введене не верные или не полные авторизационные 
данные(пользователь, пароль), то возвращается  http response: 403 


3) Получить список последних зарегистрированных доменов

Данная функция возвращает информацию о блоке, с последними зарегистрированными доменами. 
У каждого блока есть уникальный идентификатор (block_id). Используя данный идентификатор 
можно запрашивать информацию о предыдущих блоках.


url: https://api.nic.kz/prov0/v1/last
http request type: POST
Аутентификация: JwtToken

json request:
empty

json success response:
{
	"response" : {
		"result_code" : "0",
		"result_msg" : "Success",
	},
	"response_data" : {
		"block_id" : "1234",   
		"prev_block_id" : "1233",  
		"domain_list" : [
			{
				"domain" : "domain1.kz",
				"created" : "date1"
			},
			{
				"domain" : "domain2.kz",
				"created" : "date1"
			}
			...
		]
	}
}

где следующие поля обозначают:
 
"block_id" - id последнего блока
"prev_block_id" - id предыдущего запрашиваемого блока
"domain" - доменное имя
"created" - дата регистрации доменного имени, формата (31.12.2024 17:45)


json failed response:
{
	"response" : {
		"result_code" : "7",
		"result_msg" : "There are no new domain registration"
	}
}

Возвращаемые коды:

result_code : "0" , result_msg : "Success"
result_code : "7" , result_msg : "There are no new domain registration"

Если указан не верный токен, то возвращается  http response: 403 


4) Получить список доменов по id блока

Возвращает информацию о блоке с указанным id (block_id)

url: https://api.nic.kz/prov0/v1/block/id
http request type: POST
Аутентификация: JwtToken

json request:
{
	"block_id": "1234"	
}


json success response:
{
	"response" : {
		"result_code" : "0",
		"result_msg" : "Success",
	},
	"response_data" : {
		"block_id" : "1234",
		"prev_block_id" : "1233",  
		"domain_list" : [
			{
				"domain" : "domain1.kz",
				"created" : "date1"
			},
			{
				"domain" : "domain2.kz",
				"created" : "date2"
			}
			...
		]
	}
}

где следующие поля обозначают:

"block_id" - id последнего блока
"prev_block_id" - id предыдущего запрашиваемого блока
"domain" - доменное имя
"created" - дата регистрации доменного имени, формата (31.12.2024 17:45)


json failed response:
{
	"response" : {
		"result_code" : "8",
		"result_msg" : "Error: block with this id not found"
	}
}

Возвращаемые коды:

result_code : "0" , result_msg : "Success"
result_code : "6" , result_msg : "Error: wrong input parameters"
result_code : "8" , result_msg : "Error: block with this id not found"

Если указан не верный токен, то возвращается  http response: 403 


5) Получить список доменов за указанную дату

url: https://api.nic.kz/prov0/v1/domain/bydate/<date:date>
http request type: GET

Формат даты(<date:date>) должен быть YYYY-MM-DD  (Год-Месяц-День)
Аутентификация: JwtToken
                   
json success response:
{
	"response" : {
		"result_code" : "0",
		"result_msg" : "Success",
	},
	"response_data" : {
		"domain_list" : [
			{
				"domain" : "domain1.kz",
				"created" : "date1"
			},
			{
				"domain" : "domain2.kz",
				"created" : "date2"
			}
			...
		]
	}
}

где следующие поля обозначают:

"domain" - доменное имя
"created" - дата регистрации доменного имени, формата (31.12.2024 17:45)


json failed response:
{
	"response" : {
		"result_code" : "7",
		"result_msg" : "There are no new domain registration"
	}
}

Возвращаемые коды:
result_code : "0" , result_msg : "Success"
result_code : "6" , result_msg : "Error: wrong input parameters"
result_code : "7" , result_msg : "There are no new domain registration"

Если указан не верный токен, то возвращается  http response: 403