{
  "openapi": "3.0.1",
  "info": {
    "title": "order",
    "description": "API предназначен для обеспечения взаимодействия партнеров с HB.BY.",
    "termsOfService": "https://hb.by/agreements",
    "contact": {
      "name": "HB.BY",
      "url": "https://hb.by",
      "email": "support@hb.by"
    },
    "version": "1.0"
  },
  "paths": {
    "/v1/orders/hostings": {
		"post": {
			"tags": [
				"OrderApi"
			],
			"summary": "Оформить заказ хостинга",
			"description": "Пример запроса:\r\n            \r\n```\r\nPOST https://api.hb.by/v1/orders/hostings\r\n{\r\n  \"period_unit_count\": 1,\r\n  \"currency_id\": 500,\r\n  \"phone\": \"+375291234567\",\r\n  \"email\": \"user@mydomain.by\",\r\n  \"natural_person_requisites\": {\r\n    \"address\": {\r\n      \"postal_code\": \"220000\",\r\n      \"country_code\": \"BY\",\r\n      \"region\": \"Минская область\",\r\n      \"city\": \"Минск\",\r\n      \"street\": \"ул. Домбровская\",\r\n      \"building\": \"д. 9\",\r\n      \"room\": \"каб. 13.1.1\"\r\n    }\r\n  },\r\n  \"tariff_id\": 566\r\n}\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"order_id\": 99999,\r\n  \"invoice_id\": 88888,\r\n  \"invoice_url\": \"https://hb.by/s/{some short url resource}\"\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>period_unit_count</strong> — количество единиц периода, на которое оформляется заказ.\r\n</li>\r\n<li><strong>currency_id</strong> — внутренний идентификатор валюты в системе.\r\n</li>\r\n<li><strong>phone</strong> — контактный телефон лица, от имени которого создаётся заказ.\r\n</li>\r\n<li><strong>email</strong> — контактный электронный адрес лица, от имени которого создаётся заказ.\r\n</li>\r\n<li><strong>natural_person_requisites</strong> — блок реквизитов физического лица.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><strong>address</strong> — почтовый адрес физического лица.\r\n</li>\r\n<ul class=\"sublist-square\">\r\n<li><strong>postal_code</strong> — почтовый индекс.\r\n</li>\r\n<li><strong>country_code</strong> — код страны.\r\n</li>\r\n<li><strong>region</strong> — область или регион.\r\n</li>\r\n<li><strong>city</strong> — город.\r\n</li>\r\n<li><strong>street</strong> — улица.\r\n</li>\r\n<li><strong>building</strong> — номер дома или строения.\r\n</li>\r\n<li><strong>room</strong> — номер квартиры, офиса или кабинета.\r\n</li>\r\n</ul>\r\n</ul>\r\n<li><strong>tariff_id</strong> — идентификатор тарифа в запросе.\r\n</li>\r\n</ul>\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>order_id</strong> — уникальный идентификатор созданного заказа в системе HB.BY.\r\n</li>\r\n<li><strong>invoice_id</strong> — идентификатор сформированного счёта на оплату.\r\n</li>\r\n<li><strong>invoice_url</strong> — публичная короткая ссылка на страницу счёта.\r\n</li>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				}
			],
			"requestBody": {
				"content": {
					"application/json": {
						"schema": {
							"$ref": "#/components/schemas/PostHostingOrderRequestDto"
						}
					}
				}
			},
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/PostOrderResponseDto"
							}
						}
					}
				}
			}
		},
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить заказы хостинга",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/hostings\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"orders\": [\r\n    {\r\n      \"order_id\": 99999,\r\n      \"service_id\": 195,\r\n      \"number\": \"СФ-1222161\",\r\n      \"state\": \"NewOrder\",\r\n      \"order_datetime\": \"10.10.2025 20:31\",\r\n      \"complete_date\": null,\r\n      \"expiration_date\": null,\r\n      \"currency_id\": 500,\r\n      \"period_unit_type\": \"month\",\r\n      \"period_unit_count\": \"1\",\r\n      \"paid\": false,\r\n      \"completed\": false,\r\n      \"business_entity_type\": \"NaturalPerson\",\r\n      \"advanced\": {\r\n        \"tariff_id\": 566\r\n      }\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>orders</strong> — список заказов.\r\n</li>\r\n<li><strong>order_id</strong> — уникальный идентификатор заказа.\r\n</li>\r\n<li><strong>service_id</strong> — идентификатор услуги, связанной с заказом.\r\n</li>\r\n<li><strong>number</strong> — номер заказа / счёта.\r\n</li>\r\n<li><strong>state</strong> — текущий статус заказа.\r\n</li>\r\n<li><strong>order_datetime</strong> — дата и время оформления заказа.\r\n</li>\r\n<li><strong>complete_date</strong> — дата выполнения заказа.\r\n</li>\r\n<li><strong>expiration_date</strong> — дата окончания действия услуги/сертификата.\r\n</li>\r\n<li><strong>currency_id</strong> — идентификатор валюты, в которой выставлен счёт.\r\n</li>\r\n<li><strong>period_unit_type</strong> — тип единицы периода оплаты.\r\n</li>\r\n<li><strong>period_unit_count</strong> — количество единиц периода оплаты.\r\n</li>\r\n<li><strong>paid</strong> — логическое значение: заказ оплачен (true) или нет (false).\r\n</li>\r\n<li><strong>completed</strong> — логическое значение: заказ завершён (true) или нет (false).\r\n</li>\r\n<li><strong>business_entity_type</strong> — тип заказчика в реквизитах.\r\n</li>\r\n<li><strong>advanced</strong> — объект с дополнительными свойствами заказа.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><b>tariff_id</b> — идентификатор тарифа внутри блока <strong>advanced</strong>.\r\n</li>\r\n</ul>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_number",
					"in": "query",
					"description": "Номер заказа",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_id",
					"in": "query",
					"description": "ID заказа",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				},
				{
					"name": "from_order_date",
					"in": "query",
					"description": "С даты оформления",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "to_order_date",
					"in": "query",
					"description": "По дату оформления",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "service_id",
					"in": "query",
					"description": "ID услуги",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetHostingOrdersResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders/corporate-mails": {
		"post": {
			"tags": [
				"OrderApi"
			],
			"summary": "Оформить заказ электронной почты",
			"description": "Пример запроса:\r\n            \r\n```\r\nPOST https://api.hb.by/v1/orders/corporate-mails\r\n{\r\n  \"period_unit_count\": 1,\r\n  \"currency_id\": 500,\r\n  \"phone\": \"+375291234567\",\r\n  \"email\": \"user@mydomain.by\",\r\n  \"natural_person_requisites\": {\r\n    \"address\": {\r\n      \"postal_code\": \"220000\",\r\n      \"country_code\": \"BY\",\r\n      \"region\": \"Минская область\",\r\n      \"city\": \"Минск\",\r\n      \"street\": \"ул. Домбровская\",\r\n      \"building\": \"д. 9\",\r\n      \"room\": \"каб. 13.1.1\"\r\n    }\r\n  },\r\n  \"tariff_id\": 1805\r\n}\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"order_id\": 99999,\r\n  \"invoice_id\": 88888,\r\n  \"invoice_url\": \"https://hb.by/s/{some short url resource}\"\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>period_unit_count</strong> — количество единиц периода, на которое оформляется заказ.\r\n</li>\r\n<li><strong>currency_id</strong> — внутренний идентификатор валюты в системе.\r\n</li>\r\n<li><strong>phone</strong> — контактный телефон лица, от имени которого создаётся заказ.\r\n</li>\r\n<li><strong>email</strong> — контактный электронный адрес лица, от имени которого создаётся заказ.\r\n</li>\r\n<li><strong>natural_person_requisites</strong> — блок реквизитов физического лица.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><strong>address</strong> — почтовый адрес физического лица.\r\n</li>\r\n<ul class=\"sublist-square\">\r\n<li><strong>postal_code</strong> — почтовый индекс.\r\n</li>\r\n<li><strong>country_code</strong> — код страны.\r\n</li>\r\n<li><strong>region</strong> — область или регион.\r\n</li>\r\n<li><strong>city</strong> — город.\r\n</li>\r\n<li><strong>street</strong> — улица.\r\n</li>\r\n<li><strong>building</strong> — номер дома или строения.\r\n</li>\r\n<li><strong>room</strong> — номер квартиры, офиса или кабинета.\r\n</li>\r\n</ul>\r\n</ul>\r\n<li><strong>tariff_id</strong> — идентификатор тарифа в запросе.\r\n</li>\r\n</ul>\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>order_id</strong> — уникальный идентификатор созданного заказа в системе HB.BY.\r\n</li>\r\n<li><strong>invoice_id</strong> — идентификатор сформированного счёта на оплату.\r\n</li>\r\n<li><strong>invoice_url</strong> — публичная короткая ссылка на страницу счёта.\r\n</li>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				}
			],
			"requestBody": {
				"content": {
					"application/json": {
						"schema": {
							"$ref": "#/components/schemas/PostMailOrderRequestDto"
						}
					}
				}
			},
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/PostOrderResponseDto"
							}
						}
					}
				}
			}
		},
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить заказы электронной почты",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/corporate-mails\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"orders\": [\r\n    {\r\n      \"order_id\": 99999,\r\n      \"service_id\": 150,\r\n      \"number\": \"СФ-1222161\",\r\n      \"state\": \"NewOrder\",\r\n      \"order_datetime\": \"10.10.2025 20:31\",\r\n      \"complete_date\": null,\r\n      \"expiration_date\": null,\r\n      \"currency_id\": 500,\r\n      \"period_unit_type\": \"month\",\r\n      \"period_unit_count\": \"1\",\r\n      \"paid\": false,\r\n      \"completed\": false,\r\n      \"business_entity_type\": \"NaturalPerson\",\r\n      \"advanced\": {\r\n        \"tariff_id\": 1805\r\n      }\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>orders</strong> — список заказов.\r\n</li>\r\n<li><strong>order_id</strong> — уникальный идентификатор заказа.\r\n</li>\r\n<li><strong>service_id</strong> — идентификатор услуги, связанной с заказом.\r\n</li>\r\n<li><strong>number</strong> — номер заказа / счёта.\r\n</li>\r\n<li><strong>state</strong> — текущий статус заказа.\r\n</li>\r\n<li><strong>order_datetime</strong> — дата и время оформления заказа.\r\n</li>\r\n<li><strong>complete_date</strong> — дата выполнения заказа.\r\n</li>\r\n<li><strong>expiration_date</strong> — дата окончания действия услуги/сертификата.\r\n</li>\r\n<li><strong>currency_id</strong> — идентификатор валюты, в которой выставлен счёт.\r\n</li>\r\n<li><strong>period_unit_type</strong> — тип единицы периода оплаты.\r\n</li>\r\n<li><strong>period_unit_count</strong> — количество единиц периода оплаты.\r\n</li>\r\n<li><strong>paid</strong> — логическое значение: заказ оплачен (true) или нет (false).\r\n</li>\r\n<li><strong>completed</strong> — логическое значение: заказ завершён (true) или нет (false).\r\n</li>\r\n<li><strong>business_entity_type</strong> — тип заказчика в реквизитах.\r\n</li>\r\n<li><strong>advanced</strong> — объект с дополнительными свойствами заказа.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><b>tariff_id</b> — идентификатор тарифа внутри блока <strong>advanced</strong>.\r\n</li>\r\n</ul>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_number",
					"in": "query",
					"description": "Номер заказа",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_id",
					"in": "query",
					"description": "ID заказа",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				},
				{
					"name": "from_order_date",
					"in": "query",
					"description": "С даты оформления",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "to_order_date",
					"in": "query",
					"description": "По дату оформления",
					"schema": {
						"type": "string"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetMailOrdersResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders/ssl-certificates": {
		"post": {
			"tags": [
				"OrderApi"
			],
			"summary": "Оформить заказ SSL-сертификата",
			"description": "Пример запроса:\r\n            \r\n```\r\nPOST https://api.hb.by/v1/orders/ssl-certificates\r\n{\r\n  \"period_unit_count\": 1,\r\n  \"currency_id\": 500,\r\n  \"phone\": \"+375291234567\",\r\n  \"email\": \"user@mydomain.by\",\r\n  \"natural_person_requisites\": {\r\n    \"address\": {\r\n      \"postal_code\": \"220000\",\r\n      \"country_code\": \"BY\",\r\n      \"region\": \"Минская область\",\r\n      \"city\": \"Минск\",\r\n      \"street\": \"ул. Домбровская\",\r\n      \"building\": \"д. 9\",\r\n      \"room\": \"каб. 13.1.1\"\r\n    }\r\n  },\r\n  \"tariff_id\": 7027,\r\n  \"domain\": \"mydomain.by\"\r\n}\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"order_id\": 99999,\r\n  \"invoice_id\": 88888,\r\n  \"invoice_url\": \"https://hb.by/s/{some short url resource}\"\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>period_unit_count</strong>— количество единиц периода, на которое оформляется заказ.\r\n</li>\r\n<li><strong>currency_id</strong> — внутренний идентификатор валюты в системе.\r\n</li>\r\n<li><strong>phone</strong> — контактный телефон лица, от имени которого создаётся заказ.\r\n</li>\r\n<li><strong>email</strong> — контактный электронный адрес лица, от имени которого создаётся заказ.\r\n</li>\r\n<li><strong>natural_person_requisites</strong> — блок реквизитов физического лица.\r\n<ul class=\"sublist-circle\">\r\n<li><b>address</b> — почтовый адрес физического лица.\r\n</li>\r\n<ul class=\"sublist-square\">\r\n<li><b>postal_code</b> — почтовый индекс.\r\n</li>\r\n<li><b>country_code</b> — код страны.\r\n</li>\r\n<li><b>region</b> — область или регион.\r\n</li>\r\n<li><b>city</b> — город.\r\n</li>\r\n<li><b>street</b> — улица.\r\n</li>\r\n<li><b>building</b> — номер дома или строения.\r\n</li>\r\n<li><b>room</b> — номер квартиры, офиса или кабинета.\r\n</li>\r\n</ul>\r\n</ul>\r\n<li><strong>tariff_id</strong> — идентификатор тарифа в запросе.\r\n</li>\r\n<li><strong>domain</strong> — доменное имя, для которого заказывается сертификат.\r\n</li>\r\n</ul>\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>order_id</strong> — уникальный идентификатор созданного заказа корпоративной почты в системе.\r\n</li>\r\n<li><strong>invoice_id</strong> — идентификатор сформированного счёта на оплату.\r\n</li>\r\n<li><strong>invoice_url</strong> — публичная короткая ссылка на страницу счёта.\r\n</li>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				}
			],
			"requestBody": {
				"content": {
					"application/json": {
						"schema": {
							"$ref": "#/components/schemas/PostSslOrderRequestDto"
						}
					}
				}
			},
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/PostOrderResponseDto"
							}
						}
					}
				}
			}
		},
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить заказы SSL-сертификатов",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/ssl-certificates\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"orders\": [\r\n    {\r\n      \"order_id\": 99999,\r\n      \"service_id\": 60,\r\n      \"number\": \"СФ-1222161\",\r\n      \"state\": \"NewOrder\",\r\n      \"order_datetime\": \"10.10.2025 20:31\",\r\n      \"complete_date\": null,\r\n      \"expiration_date\": null,\r\n      \"currency_id\": 500,\r\n      \"period_unit_type\": \"year\",\r\n      \"period_unit_count\": \"1\",\r\n      \"paid\": false,\r\n      \"completed\": false,\r\n      \"business_entity_type\": \"NaturalPerson\",\r\n      \"advanced\": {\r\n        \"domain\": \"mydomain.by\",\r\n        \"use_csr\": false,\r\n        \"tariff_id\": 7027,\r\n        \"valid_from_date\": null,\r\n        \"valid_till_date\": null\r\n      }\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>orders</strong> — список заказов; каждый элемент представляет отдельный заказ.\r\n</li>\r\n<li><strong>order_id</strong> — уникальный идентификатор заказа.\r\n</li>\r\n<li><strong>service_id</strong> — идентификатор услуги, по которой создан заказ.\r\n</li>\r\n<li><strong>number</strong> — номер заказа.\r\n</li>\r\n<li><strong>state</strong> — текущий статус услуги/заказа.\r\n</li>\r\n<li><strong>order_datetime</strong> — дата и время оформления заказа.\r\n</li>\r\n<li><strong>complete_date</strong> — дата выполнения заказа.\r\n</li>\r\n<li><strong>expiration_date</strong> — дата истечения услуги/заказа.\r\n</li>\r\n<li><strong>currency_id</strong> — идентификатор валюты, в которой выставлен счёт.\r\n</li>\r\n<li><strong>period_unit_type</strong> — тип единицы периода оплаты.\r\n</li>\r\n<li><strong>period_unit_count</strong> — количество единиц периода оплаты.\r\n</li>\r\n<li><strong>paid</strong> — логическое значение: признак того, что заказ оплачен.\r\n</li>\r\n<li><strong>completed</strong> — логическое значение: признак того, что заказ выполнен.\r\n</li>\r\n<li><strong>business_entity_type</strong> — тип заказчика в реквизитах.\r\n</li>\r\n<li><strong>advanced</strong> — объект с дополнительными значениями, связанными с заказом.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><b>domain</b> — доменное имя (внутри блока advanced), к которому относится заказ.\r\n<li><b>use_csr</b> — признак использования пользовательского CSR.\r\n<li><b>tariff_id</b> — идентификатор тарифа или наименование SSL-сертификата.\r\n<li><b>valid_from_date</b> — дата начала действия сертификата.\r\n<li><b>valid_till_date</b> — дата окончания действия сертификата.\r\n</ul>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_number",
					"in": "query",
					"description": "Номер заказа",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_id",
					"in": "query",
					"description": "ID заказа",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				},
				{
					"name": "from_order_date",
					"in": "query",
					"description": "С даты оформления",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "to_order_date",
					"in": "query",
					"description": "По дату оформления",
					"schema": {
						"type": "string"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetSslOrdersResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders/domains": {
		"post": {
			"tags": [
				"OrderApi"
			],
			"summary": "Оформить заказ домена",
			"description": "Пример запроса:\r\n            \r\n```\r\nPOST https://api.hb.by/v1/orders/domains\r\n{\r\n  \"period_unit_count\": 1,\r\n  \"currency_id\": 500,\r\n  \"phone\": \"+375291234567\",\r\n  \"email\": \"user@mydomain.by\",\r\n  \"natural_person_requisites\": {\r\n    \"address\": {\r\n      \"postal_code\": \"220000\",\r\n      \"country_code\": \"BY\",\r\n      \"region\": \"Минская область\",\r\n      \"city\": \"Минск\",\r\n      \"street\": \"ул. Домбровская\",\r\n      \"building\": \"д. 9\",\r\n      \"room\": \"каб. 13.1.1\"\r\n    }\r\n  },\r\n  \"domain\": \"mydomain.by\",\r\n  \"whois_person_requisites\": {\r\n    \"citizenship\": \"BY\",\r\n    \"series\": \"BM\",\r\n    \"number\": \"1234567\",\r\n    \"organization\": \"РОВД Октябрьского р-на г. Минска\",\r\n    \"identity_number\": \"1234567A901PB4\",\r\n    \"date_of_issue\": \"10.10.2005\"\r\n  }\r\n}\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"order_id\": 99999,\r\n  \"invoice_id\": 88888,\r\n  \"invoice_url\": \"https://hb.by/s/{some short url resource}\"\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>period_unit_count</strong> — количество единиц периода, на которое оформляется заказ.\r\n</li>\r\n<li><strong>currency_id</strong> — внутренний идентификатор валюты в системе.\r\n</li>\r\n<li><strong>phone</strong> — контактный телефон лица, от имени которого создаётся заказ.\r\n</li>\r\n<li><strong>email</strong> — контактный электронный адрес лица, от имени которого создаётся заказ.\r\n</li>\r\n<li><strong>natural_person_requisites</strong> — блок реквизитов физического лица.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><b>address</b> — почтовый адрес физического лица.\r\n</li>\r\n<ul class=\"sublist-square\">\r\n<li><b>postal_code</b> — почтовый индекс.\r\n</li>\r\n<li><b>country_code</b> — код страны.\r\n</li>\r\n<li><b>region</b> — область или регион.\r\n</li>\r\n<li><b>city</b> — город.\r\n</li>\r\n<li><b>street</b> — улица.\r\n</li>\r\n<li><b>building</b> — номер дома или строения.\r\n</li>\r\n<li><b>room</b> — номер квартиры, офиса или кабинета.\r\n</li>\r\n</ul>\r\n</ul>\r\n<li><strong>domain</strong> — доменное имя, по которому создаётся заказ.\r\n</li>\r\n<li><strong>whois_person_requisites</strong> — блок WHOIS-реквизитов владельца домена.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><strong>citizenship</strong> — гражданство владельца.\r\n</li>\r\n<li><strong>series</strong> — серия документа, удостоверяющего личность.\r\n</li>\r\n<li><strong>number</strong> — номер документа, удостоверяющего личность.\r\n</li>\r\n<li><strong>organization</strong> — организация или орган, указанные в документе.\r\n</li>\r\n<li><strong>identity_number</strong> — идентификационный номер.\r\n</li>\r\n<li><strong>date_of_issue</strong> — дата выдачи документа.\r\n</li>\r\n</ul>\r\n</ul>\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>order_id</strong> — уникальный идентификатор созданного заказа домена в системе.\r\n</li>\r\n<li><strong>invoice_id</strong> — идентификатор сформированного счёта на оплату.\r\n</li>\r\n<li><strong>invoice_url</strong> — публичная короткая ссылка на счёт (короткий URL).\r\n</li>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				}
			],
			"requestBody": {
				"content": {
					"application/json": {
						"schema": {
							"$ref": "#/components/schemas/PostDomainOrderRequestDto"
						}
					}
				}
			},
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/PostOrderResponseDto"
							}
						}
					}
				}
			}
		},
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить заказы доменов",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/domains\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"orders\": [\r\n    {\r\n      \"order_id\": 99999,\r\n      \"service_id\": 30,\r\n      \"number\": \"СФ-1222161\",\r\n      \"state\": \"NewOrder\",\r\n      \"order_datetime\": \"10.10.2025 20:31\",\r\n      \"complete_date\": null,\r\n      \"expiration_date\": null,\r\n      \"currency_id\": 500,\r\n      \"period_unit_type\": \"year\",\r\n      \"period_unit_count\": \"1\",\r\n      \"paid\": false,\r\n      \"completed\": false,\r\n      \"business_entity_type\": \"NaturalPerson\",\r\n      \"advanced\": {\r\n        \"domain\": \"mydomain.by\",\r\n        \"registered\": false,\r\n        \"renewed\": false,\r\n        \"registration_tariff_id\": 2000,\r\n        \"renew_tariff_id\": 2001\r\n      }\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>orders</strong> — список найденных заказов доменов.\r\n</li>\r\n<li><strong>order_id</strong> — уникальный идентификатор заказа в системе.\r\n</li>\r\n<li><strong>service_id</strong> — идентификатор услуги, к которой относится заказ.\r\n</li>\r\n<li><strong>number</strong> — номер/код заказа.\r\n</li>\r\n<li><strong>state</strong> — текущий статус заказа/услуги.\r\n</li>\r\n<li><strong>order_datetime</strong> — дата и время оформления заказа.\r\n</li>\r\n<li><strong>complete_date</strong> — дата выполнения заказа.\r\n</li>\r\n<li><strong>expiration_date</strong> — дата истечения/окончания действия заказа/услуги.\r\n</li>\r\n<li><strong>currency_id</strong> — идентификатор валюты, в которой выставлен счёт/оплата.\r\n</li>\r\n<li><strong>period_unit_type</strong> — единица периода оплаты.\r\n</li>\r\n<li><strong>period_unit_count</strong> — количество единиц периода оплаты.\r\n</li>\r\n<li><strong>paid</strong> — признак оплаты: true если заказ оплачен, false — если нет.\r\n</li>\r\n<li><strong>completed</strong> — признак завершения/выполнения заказа: true — выполнен, false — не выполнен.\r\n</li>\r\n<li><strong>business_entity_type</strong> — тип заказчика в реквизитах.\r\n</li>\r\n<li><strong>advanced</strong> — дополнительный объект с расширенными данными.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><b>domain</b> — доменное имя, к которому относится заказ.\r\n</li>\r\n<li><b>registered</b> — признак, что домен зарегистрирован (true) или ещё не зарегистрирован (false).\r\n</li>\r\n<li><b>renewed</b> — признак продления домена.\r\n</li>\r\n<li><b>registration_tariff_id</b> — идентификатор тарифа, использованного при регистрации домена.\r\n</li>\r\n<li><b>renew_tariff_id</b> — идентификатор тарифа, использованного при продлении домена.\r\n</li>\r\n</ul>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_number",
					"in": "query",
					"description": "Номер заказа",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_id",
					"in": "query",
					"description": "ID заказа",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				},
				{
					"name": "from_order_date",
					"in": "query",
					"description": "С даты оформления",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "to_order_date",
					"in": "query",
					"description": "По дату оформления",
					"schema": {
						"type": "string"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetDomainOrdersResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders/services": {
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить доступные услуги",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/services\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"services\": [\r\n    ...\r\n    {\r\n      \"service_id\": 195,\r\n      \"canonical_name\": \"UnixHosting\",\r\n      \"name\": \"Unix-хостинг\"\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>services</strong> — список доступных услуг в системе.\r\n</li>\r\n<li><strong>service_id</strong> — уникальный идентификатор услуги.\r\n</li>\r\n<li><strong>canonical_name</strong> — каноническое (внутреннее) имя услуги.\r\n</li>\r\n<li><strong>name</strong> — наименование услуги, отображаемое в интерфейсе.\r\n</li>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetServicesResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders/hostings/tariffs": {
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить доступные тарифы хостинга",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/hostings/tariffs?currency_id=500&service_id=195\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"tariffs\": [\r\n    {\r\n      \"tariff_id\": 566,\r\n      \"tariff_name\": \"Unix Старт\",\r\n      \"service_id\": 195,\r\n      \"period_type\": \"month\",\r\n      \"prices\": [\r\n        {\r\n          \"period\": 1,\r\n          \"price\": 6.00\r\n        },\r\n        ...\r\n      ]\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>tariffs</strong> — список доступных тарифов хостинга.\r\n</li>\r\n<li><strong>tariff_id</strong> — целочисленный уникальный идентификатор тарифа.\r\n</li>\r\n<li><strong>tariff_name</strong> — читаемое название тарифа.\r\n</li>\r\n<li><strong>service_id</strong> — идентификатор услуги в системе.\r\n</li>\r\n<li><strong>period_type</strong> — единица измерения периода оплаты.\r\n</li>\r\n<li><strong>prices</strong> — варианты стоимости для разных периодов оплаты.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><b>period</b> — период оплаты в единицах, указанных в <b>period_type</b>.\r\n</li>\r\n<li><b>price</b> — стоимость за указанный <b>period</b>.\r\n</li>\r\n</ul>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "currency_id",
					"in": "query",
					"description": "ID валюты",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				},
				{
					"name": "service_id",
					"in": "query",
					"description": "ID услуги",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetTariffsResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders/corporate-mails/tariffs": {
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить доступные тарифы электронной почты",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/corporate-mails/tariffs?currency_id=500\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"tariffs\": [\r\n    {\r\n      \"tariff_id\": 1805,\r\n      \"tariff_name\": \"Почта-5\",\r\n      \"service_id\": 150,\r\n      \"period_type\": \"month\",\r\n      \"prices\": [\r\n        {\r\n          \"period\": 1,\r\n          \"price\": 4.50\r\n        },\r\n        ...\r\n      ]\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>tariffs</strong> — список доступных тарифов на корпоративную почту.\r\n</li>\r\n<li><strong>tariff_id</strong> — целочисленный уникальный идентификатор тарифа.\r\n</li>\r\n<li><strong>tariff_name</strong> — читаемое название тарифа.\r\n</li>\r\n<li><strong>service_id</strong> — идентификатор услуги в системе.\r\n</li>\r\n<li><strong>period_type</strong> — единица измерения периода оплаты.\r\n</li>\r\n<li><strong>prices</strong> — варианты стоимости для разных периодов оплаты.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><b>period</b> — период оплаты в единицах, указанных в <b>period_type</b>.\r\n</li>\r\n<li><b>price</b> — стоимость за указанный <b>period</b>.\r\n</li>\r\n</ul>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "currency_id",
					"in": "query",
					"description": "ID валюты",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetTariffsResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders/ssl-certificates/tariffs": {
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить доступные SSL-сертификаты",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/ssl-certificates/tariffs?currency_id=500\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"tariffs\": [\r\n    {\r\n      \"tariff_id\": 7027,\r\n      \"tariff_name\": \"GlobalSign AlphaSSL Domain\",\r\n      \"service_id\": 60,\r\n      \"period_type\": \"year\",\r\n      \"prices\": [\r\n        {\r\n          \"period\": 1,\r\n          \"price\": 39.00\r\n        }\r\n      ]\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>tariffs</strong> — список доступных тарифов на SSL-сертификаты.\r\n</li>\r\n<li><strong>tariff_id</strong> — целочисленный уникальный идентификатор тарифа.\r\n</li>\r\n<li><strong>tariff_name</strong> — название тарифа/пакета.\r\n</li>\r\n<li><strong>service_id</strong> — идентификатор услуги в системе.\r\n</li>\r\n<li><strong>period_type</strong> — единица измерения периода оплаты.\r\n</li>\r\n<li><strong>prices</strong> — варианты цены для разных периодов оплаты.\r\n</li>\r\n<ul class=\"sublist-circle\">\r\n<li><b>period</b> — период оплаты указанный в <b>period_type</b>.\r\n</li>\r\n<li><b>price</b> — стоимость за указанный <b>period</b>.\r\n</li>\r\n</ul>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "currency_id",
					"in": "query",
					"description": "ID валюты",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetTariffsResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders/domains/zones": {
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить доступные доменные зоны",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders/domains/zones?currency_id=500\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"domain_zones\": [\r\n    {\r\n      \"domain_zone_id\": 1,\r\n      \"name\": \"by\",\r\n      \"min_period\": 1,\r\n      \"max_period\": 2,\r\n      \"actual_registration_tariff_id\": 2000,\r\n      \"registration_price\": 33.00,\r\n      \"actual_renew_tariff_id\": 2001,\r\n      \"renew_price\": 33.00,\r\n      \"period_type\": \"year\"\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>domain_zones</strong> — список доступных доменных зон/ТЛД.\r\n</li>\r\n<li><strong>domain_zone_id</strong> — целочисленный уникальный идентификатор зоны.\r\n</li>\r\n<li><strong>name</strong> — имя зоны/суффикса (например, by, com, net).\r\n</li>\r\n<li><strong>min_period</strong> — минимальный разрешённый период заказа.\r\n</li>\r\n<li><strong>max_period</strong> — максимальный разрешённый период заказа.\r\n</li>\r\n<li><strong>actual_registration_tariff_id</strong> — идентификатор текущего тарифа/предложения для регистрации в этой зоне.\r\n</li>\r\n<li><strong>registration_price</strong> — цена регистрации.\r\n</li>\r\n<li><strong>actual_renew_tariff_id</strong> — идентификатор текущего тарифа для продления в этой зоне.\r\n</li>\r\n<li><strong>renew_price</strong> — цена продления.\r\n</li>\r\n<li><strong>period_type</strong> — единица измерения периода, то есть в каких единицах указаны <b>min_period</b> / <b>max_period</b>.\r\n</li>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "currency_id",
					"in": "query",
					"description": "ID валюты",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetDomainZonesResponseDto"
							}
						}
					}
				}
			}
		}
    },
    "/v1/orders": {
		"get": {
			"tags": [
				"OrderApi"
			],
			"summary": "Получить все заказы",
			"description": "Пример запроса:\r\n            \r\n```\r\nGET https://api.hb.by/v1/orders\r\n```\r\n            \r\nПример ответа\r\n            \r\n```\r\n{\r\n  \"orders\": [\r\n    {\r\n      \"order_id\": 99999,\r\n      \"service_id\": 30,\r\n      \"number\": \"СФ-1222161\",\r\n      \"state\": \"NewOrder\",\r\n      \"order_datetime\": \"10.10.2025 20:31\",\r\n      \"complete_date\": null,\r\n      \"expiration_date\": null,\r\n      \"currency_id\": 500,\r\n      \"period_unit_type\": \"year\",\r\n      \"period_unit_count\": \"1\",\r\n      \"paid\": false,\r\n      \"completed\": false,\r\n      \"business_entity_type\": \"NaturalPerson\"\r\n    },\r\n    ...\r\n  ]\r\n}\r\n```\r\n\r\n```\r\n<ul>\r\n<li><strong>orders</strong> — список заказов.\r\n</li>\r\n<li><strong>order_id</strong> — уникальный идентификатор заказа.\r\n</li>\r\n<li><strong>service_id</strong> — идентификатор услуги, на которую оформлен заказ.\r\n</li>\r\n<li><strong>number</strong> — номер (код) заказа.\r\n</li>\r\n<li><strong>state</strong> — текущий статус заказа/услуги.\r\n</li>\r\n<li><strong>order_datetime</strong> — дата и время оформления заказа.\r\n</li>\r\n<li><strong>complete_date</strong> — дата выполнения заказа; может быть пустой (null), если ещё не выполнен.\r\n</li>\r\n<li><strong>expiration_date</strong> — дата истечения заказа; может быть пустой (null), если не применимо.\r\n</li>\r\n<li><strong>currency_id</strong> — идентификатор валюты, в которой указаны суммы по заказу.\r\n</li>\r\n<li><strong>period_unit_type</strong> — единица периода оплаты (тип периода).\r\n</li>\r\n<li><strong>period_unit_count</strong> — количество единиц периода оплаты.\r\n</li>\r\n<li><strong>paid</strong> — признак оплаты заказа (оплачен/не оплачен).\r\n</li>\r\n<li><strong>completed</strong> — признак того, что заказ выполнен.\r\n</li>\r\n<li><strong>business_entity_type</strong> — тип заказчика в реквизитах.\r\n</li>\r\n</ul>\r\n```",
			"parameters": [
				{
					"name": "x-auth-token",
					"in": "header",
					"description": "API-ключ",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_number",
					"in": "query",
					"description": "Номер заказа",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "order_id",
					"in": "query",
					"description": "ID заказа",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				},
				{
					"name": "from_order_date",
					"in": "query",
					"description": "С даты оформления",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "to_order_date",
					"in": "query",
					"description": "По дату оформления",
					"schema": {
						"type": "string"
					}
				},
				{
					"name": "service_id",
					"in": "query",
					"description": "ID услуги",
					"schema": {
						"type": "integer",
						"format": "int32"
					}
				}
			],
			"responses": {
				"400": {
					"description": "Bad Request",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/ErrorResponseDto"
							}
						}
					}
				},
				"500": {
					"description": "Internal Server Error"
				},
				"403": {
					"description": "Forbidden"
				},
				"404": {
					"description": "Not Found"
				},
				"200": {
					"description": "OK",
					"content": {
						"application/json": {
							"schema": {
								"$ref": "#/components/schemas/GetOrdersResponseDto"
							}
						}
					}
				}
			}
		}
    }
  },
  "components": {
    "schemas": {
      "AddressDto": {
        "required": [
          "building",
          "city",
          "country_code",
          "postal_code",
          "region",
          "room",
          "street"
        ],
        "type": "object",
        "properties": {
          "postal_code": {
            "minLength": 1,
            "type": "string",
            "description": "Почтовый индекс"
          },
          "country_code": {
            "minLength": 1,
            "type": "string",
            "description": "Страна"
          },
          "region": {
            "minLength": 1,
            "type": "string",
            "description": "Регион / Область"
          },
          "city": {
            "minLength": 1,
            "type": "string",
            "description": "Населенный пункт"
          },
          "street": {
            "minLength": 1,
            "type": "string",
            "description": "Улица"
          },
          "building": {
            "minLength": 1,
            "type": "string",
            "description": "Дом"
          },
          "room": {
            "minLength": 1,
            "type": "string",
            "description": "Помещение"
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "BankRequisitesDto": {
        "type": "object",
        "properties": {
          "bank_name": {
            "type": "string",
            "description": "Наименование банка",
            "nullable": true
          },
          "swift": {
            "type": "string",
            "description": "БИК SWIFT",
            "nullable": true
          },
          "iban": {
            "type": "string",
            "description": "IBAN",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "CompanyDto": {
        "type": "object",
        "properties": {
          "registration_number": {
            "type": "string",
            "description": "Регистрационный номер (только для BY/БЕЛ)",
            "nullable": true
          },
          "registration_organization": {
            "type": "string",
            "description": "Орган, осуществивший регистрацию (только для BY/БЕЛ)",
            "nullable": true
          },
          "registration_issue_number": {
            "type": "string",
            "description": "Номер решения о государственной регистрации (только для BY/БЕЛ)",
            "nullable": true
          },
          "registration_issue_date": {
            "type": "string",
            "description": "Дата решения о государственной регистрации (только для BY/БЕЛ)",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "is_government_company": {
            "type": "boolean",
            "description": "Государственная организация (только для BY/БЕЛ)",
            "nullable": true
          },
          "inn": {
            "type": "string",
            "description": "ИНН (только для RU/SU/РФ)",
            "nullable": true
          },
          "kpp": {
            "type": "string",
            "description": "КПП (только для RU/SU/РФ)",
            "nullable": true
          },
          "ogrn": {
            "type": "string",
            "description": "ОГРН (только для RU/SU/РФ)",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "DomainOrderAdvancedDto": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Домен",
            "nullable": true
          },
          "registered": {
            "type": "boolean",
            "description": "Признак регистрации",
            "nullable": true
          },
          "renewed": {
            "type": "boolean",
            "description": "Признак продления",
            "nullable": true
          },
          "registration_tariff_id": {
            "type": "integer",
            "description": "Привязанный тариф регистрации",
            "format": "int32",
            "nullable": true
          },
          "renew_tariff_id": {
            "type": "integer",
            "description": "Привязанный тариф продления",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Расширенное DTO ответа"
      },
      "DomainOrderDto": {
        "required": [
          "business_entity_type",
          "completed",
          "currency_id",
          "number",
          "order_datetime",
          "order_id",
          "paid",
          "period_unit_count",
          "period_unit_type",
          "service_id",
          "state"
        ],
        "type": "object",
        "properties": {
          "order_id": {
            "type": "integer",
            "description": "ID заказа",
            "format": "int32"
          },
          "service_id": {
            "type": "integer",
            "description": "ID услуги",
            "format": "int32"
          },
          "number": {
            "type": "string",
            "description": "Номер заказа",
            "nullable": true
          },
          "state": {
            "type": "string",
            "description": "Статус услуги",
            "nullable": true
          },
          "order_datetime": {
            "type": "string",
            "description": "Дата оформления заказа",
            "format": "date-time"
          },
          "complete_date": {
            "type": "string",
            "description": "Дата выполнения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "expiration_date": {
            "type": "string",
            "description": "Дата истечения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32"
          },
          "period_unit_type": {
            "type": "string",
            "description": "Тип периода оплаты",
            "nullable": true
          },
          "period_unit_count": {
            "type": "integer",
            "description": "Количество единиц периода оплаты",
            "format": "int32"
          },
          "paid": {
            "type": "boolean",
            "description": "Статус оплаты"
          },
          "completed": {
            "type": "boolean",
            "description": "Статус выполнения"
          },
          "business_entity_type": {
            "type": "string",
            "description": "Тип заказчика в реквизитах",
            "nullable": true
          },
          "advanced": {
            "$ref": "#/components/schemas/DomainOrderAdvancedDto"
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "DomainZoneTariffDto": {
        "required": [
          "actual_registration_tariff_id",
          "actual_renew_tariff_id",
          "domain_zone_id",
          "max_period",
          "min_period",
          "name",
          "period_type",
          "registration_price",
          "renew_price"
        ],
        "type": "object",
        "properties": {
          "domain_zone_id": {
            "type": "integer",
            "description": "ID зоны",
            "format": "int32"
          },
          "name": {
            "type": "string",
            "description": "Название зоны",
            "nullable": true
          },
          "min_period": {
            "type": "integer",
            "description": "Минимальный период заказа",
            "format": "int32"
          },
          "max_period": {
            "type": "integer",
            "description": "Максимальный период заказа",
            "format": "int32"
          },
          "actual_registration_tariff_id": {
            "type": "integer",
            "description": "ID тарифа регистрации",
            "format": "int32"
          },
          "registration_price": {
            "type": "number",
            "description": "Стоимость регистрации",
            "format": "double"
          },
          "actual_renew_tariff_id": {
            "type": "integer",
            "description": "ID тарифа продления",
            "format": "int32"
          },
          "renew_price": {
            "type": "number",
            "description": "Стоимость продления",
            "format": "double"
          },
          "period_type": {
            "type": "string",
            "description": "Период оплаты",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "ErrorResponseDto": {
        "required": [
          "message"
        ],
        "type": "object",
        "properties": {
          "message": {
            "type": "string",
            "description": "Сообщение об ошибке",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO сообщения об ошибке"
      },
      "GetDomainOrdersResponseDto": {
        "type": "object",
        "properties": {
          "orders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DomainOrderDto"
            },
            "description": "Список заказов",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "GetDomainZonesResponseDto": {
        "type": "object",
        "properties": {
          "domain_zones": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DomainZoneTariffDto"
            },
            "description": "Список доменных зон",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "GetHostingOrdersResponseDto": {
        "type": "object",
        "properties": {
          "orders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HostingOrderDto"
            },
            "description": "Список заказов",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "GetMailOrdersResponseDto": {
        "type": "object",
        "properties": {
          "orders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MailOrderDto"
            },
            "description": "Список заказов",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "GetOrdersResponseDto": {
        "type": "object",
        "properties": {
          "orders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrderDto"
            },
            "description": "Список заказов",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "GetServicesResponseDto": {
        "type": "object",
        "properties": {
          "services": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ServiceDto"
            },
            "description": "Список услуг",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "GetSslOrdersResponseDto": {
        "type": "object",
        "properties": {
          "orders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SslOrderDto"
            },
            "description": "Список заказов",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "GetTariffsResponseDto": {
        "type": "object",
        "properties": {
          "tariffs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TariffDto"
            },
            "description": "Список тарифов",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "HostingOrderAdvancedDto": {
        "type": "object",
        "properties": {
          "tariff_id": {
            "type": "integer",
            "description": "Тариф",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "HostingOrderDto": {
        "required": [
          "business_entity_type",
          "completed",
          "currency_id",
          "number",
          "order_datetime",
          "order_id",
          "paid",
          "period_unit_count",
          "period_unit_type",
          "service_id",
          "state"
        ],
        "type": "object",
        "properties": {
          "order_id": {
            "type": "integer",
            "description": "ID заказа",
            "format": "int32"
          },
          "service_id": {
            "type": "integer",
            "description": "ID услуги",
            "format": "int32"
          },
          "number": {
            "type": "string",
            "description": "Номер заказа",
            "nullable": true
          },
          "state": {
            "type": "string",
            "description": "Статус услуги",
            "nullable": true
          },
          "order_datetime": {
            "type": "string",
            "description": "Дата оформления заказа",
            "format": "date-time"
          },
          "complete_date": {
            "type": "string",
            "description": "Дата выполнения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "expiration_date": {
            "type": "string",
            "description": "Дата истечения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32"
          },
          "period_unit_type": {
            "type": "string",
            "description": "Тип периода оплаты",
            "nullable": true
          },
          "period_unit_count": {
            "type": "integer",
            "description": "Количество единиц периода оплаты",
            "format": "int32"
          },
          "paid": {
            "type": "boolean",
            "description": "Статус оплаты"
          },
          "completed": {
            "type": "boolean",
            "description": "Статус выполнения"
          },
          "business_entity_type": {
            "type": "string",
            "description": "Тип заказчика в реквизитах",
            "nullable": true
          },
          "advanced": {
            "$ref": "#/components/schemas/HostingOrderAdvancedDto"
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "IndividualBusinessmanDto": {
        "type": "object",
        "properties": {
          "ucn": {
            "type": "string",
            "description": "УНП / ИНН",
            "nullable": true
          },
          "legal_address": {
            "$ref": "#/components/schemas/AddressDto"
          },
          "postal_address": {
            "$ref": "#/components/schemas/AddressDto"
          },
          "bank_requisites": {
            "$ref": "#/components/schemas/BankRequisitesDto"
          },
          "last_name": {
            "type": "string",
            "description": "Фамилия заказчика",
            "nullable": true
          },
          "first_name": {
            "type": "string",
            "description": "Имя заказчика",
            "nullable": true
          },
          "middle_name": {
            "type": "string",
            "description": "Отчество заказчика",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "JuridicalPersonDto": {
        "type": "object",
        "properties": {
          "ucn": {
            "type": "string",
            "description": "УНП / ИНН",
            "nullable": true
          },
          "legal_address": {
            "$ref": "#/components/schemas/AddressDto"
          },
          "postal_address": {
            "$ref": "#/components/schemas/AddressDto"
          },
          "bank_requisites": {
            "$ref": "#/components/schemas/BankRequisitesDto"
          },
          "company_name": {
            "type": "string",
            "description": "Полное наименование организации",
            "nullable": true
          },
          "executive_last_name": {
            "type": "string",
            "description": "Фамилия руководителя",
            "nullable": true
          },
          "executive_first_name": {
            "type": "string",
            "description": "Имя руководителя",
            "nullable": true
          },
          "executive_middle_name": {
            "type": "string",
            "description": "Отчество руководителя",
            "nullable": true
          },
          "post_of_executive": {
            "type": "string",
            "description": "Должность руководителя",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "MailOrderAdvancedDto": {
        "type": "object",
        "properties": {
          "tariff_id": {
            "type": "integer",
            "description": "Тариф",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "MailOrderDto": {
        "required": [
          "business_entity_type",
          "completed",
          "currency_id",
          "number",
          "order_datetime",
          "order_id",
          "paid",
          "period_unit_count",
          "period_unit_type",
          "service_id",
          "state"
        ],
        "type": "object",
        "properties": {
          "order_id": {
            "type": "integer",
            "description": "ID заказа",
            "format": "int32"
          },
          "service_id": {
            "type": "integer",
            "description": "ID услуги",
            "format": "int32"
          },
          "number": {
            "type": "string",
            "description": "Номер заказа",
            "nullable": true
          },
          "state": {
            "type": "string",
            "description": "Статус услуги",
            "nullable": true
          },
          "order_datetime": {
            "type": "string",
            "description": "Дата оформления заказа",
            "format": "date-time"
          },
          "complete_date": {
            "type": "string",
            "description": "Дата выполнения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "expiration_date": {
            "type": "string",
            "description": "Дата истечения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32"
          },
          "period_unit_type": {
            "type": "string",
            "description": "Тип периода оплаты",
            "nullable": true
          },
          "period_unit_count": {
            "type": "integer",
            "description": "Количество единиц периода оплаты",
            "format": "int32"
          },
          "paid": {
            "type": "boolean",
            "description": "Статус оплаты"
          },
          "completed": {
            "type": "boolean",
            "description": "Статус выполнения"
          },
          "business_entity_type": {
            "type": "string",
            "description": "Тип заказчика в реквизитах",
            "nullable": true
          },
          "advanced": {
            "$ref": "#/components/schemas/MailOrderAdvancedDto"
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "NaturalPersonDto": {
        "type": "object",
        "properties": {
          "last_name": {
            "type": "string",
            "description": "Фамилия заказчика",
            "nullable": true
          },
          "first_name": {
            "type": "string",
            "description": "Имя заказчика",
            "nullable": true
          },
          "middle_name": {
            "type": "string",
            "description": "Отчество заказчика",
            "nullable": true
          },
          "address": {
            "$ref": "#/components/schemas/AddressDto"
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "OrderDto": {
        "required": [
          "business_entity_type",
          "completed",
          "currency_id",
          "number",
          "order_datetime",
          "order_id",
          "paid",
          "period_unit_count",
          "period_unit_type",
          "service_id",
          "state"
        ],
        "type": "object",
        "properties": {
          "order_id": {
            "type": "integer",
            "description": "ID заказа",
            "format": "int32"
          },
          "service_id": {
            "type": "integer",
            "description": "ID услуги",
            "format": "int32"
          },
          "number": {
            "type": "string",
            "description": "Номер заказа",
            "nullable": true
          },
          "state": {
            "type": "string",
            "description": "Статус услуги",
            "nullable": true
          },
          "order_datetime": {
            "type": "string",
            "description": "Дата оформления заказа",
            "format": "date-time"
          },
          "complete_date": {
            "type": "string",
            "description": "Дата выполнения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "expiration_date": {
            "type": "string",
            "description": "Дата истечения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32"
          },
          "period_unit_type": {
            "type": "string",
            "description": "Тип периода оплаты",
            "nullable": true
          },
          "period_unit_count": {
            "type": "integer",
            "description": "Количество единиц периода оплаты",
            "format": "int32"
          },
          "paid": {
            "type": "boolean",
            "description": "Статус оплаты"
          },
          "completed": {
            "type": "boolean",
            "description": "Статус выполнения"
          },
          "business_entity_type": {
            "type": "string",
            "description": "Тип заказчика в реквизитах",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "PassportDto": {
        "type": "object",
        "properties": {
          "citizenship": {
            "type": "string",
            "description": "Гражданство (код страны)",
            "nullable": true
          },
          "series": {
            "type": "string",
            "description": "Серия",
            "nullable": true
          },
          "number": {
            "type": "string",
            "description": "Номер",
            "nullable": true
          },
          "organization": {
            "type": "string",
            "description": "Кем выдан",
            "nullable": true
          },
          "identity_number": {
            "type": "string",
            "description": "Идентификационный номер",
            "nullable": true
          },
          "date_of_issue": {
            "type": "string",
            "description": "Дата выдачи",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "date_of_birth": {
            "type": "string",
            "description": "Дата рождения (только для RU/SU/РФ)",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "PostDomainOrderRequestDto": {
        "type": "object",
        "properties": {
          "period_unit_count": {
            "type": "integer",
            "description": "Период оплаты",
            "format": "int32",
            "nullable": true
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "description": "Телефон",
            "nullable": true
          },
          "email": {
            "type": "string",
            "description": "Почта",
            "nullable": true
          },
          "natural_person_requisites": {
            "$ref": "#/components/schemas/NaturalPersonDto"
          },
          "individual_businessman_requisites": {
            "$ref": "#/components/schemas/IndividualBusinessmanDto"
          },
          "juridical_person_requisites": {
            "$ref": "#/components/schemas/JuridicalPersonDto"
          },
          "domain": {
            "type": "string",
            "description": "Домен",
            "nullable": true
          },
          "whois_person_requisites": {
            "$ref": "#/components/schemas/PassportDto"
          },
          "whois_company_requisites": {
            "$ref": "#/components/schemas/CompanyDto"
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "PostHostingOrderRequestDto": {
        "type": "object",
        "properties": {
          "period_unit_count": {
            "type": "integer",
            "description": "Период оплаты",
            "format": "int32",
            "nullable": true
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "description": "Телефон",
            "nullable": true
          },
          "email": {
            "type": "string",
            "description": "Почта",
            "nullable": true
          },
          "natural_person_requisites": {
            "$ref": "#/components/schemas/NaturalPersonDto"
          },
          "individual_businessman_requisites": {
            "$ref": "#/components/schemas/IndividualBusinessmanDto"
          },
          "juridical_person_requisites": {
            "$ref": "#/components/schemas/JuridicalPersonDto"
          },
          "tariff_id": {
            "type": "integer",
            "description": "ID тарифа",
            "format": "int32",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "PostMailOrderRequestDto": {
        "required": [
          "tariff_id"
        ],
        "type": "object",
        "properties": {
          "period_unit_count": {
            "type": "integer",
            "description": "Период оплаты",
            "format": "int32",
            "nullable": true
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "description": "Телефон",
            "nullable": true
          },
          "email": {
            "type": "string",
            "description": "Почта",
            "nullable": true
          },
          "natural_person_requisites": {
            "$ref": "#/components/schemas/NaturalPersonDto"
          },
          "individual_businessman_requisites": {
            "$ref": "#/components/schemas/IndividualBusinessmanDto"
          },
          "juridical_person_requisites": {
            "$ref": "#/components/schemas/JuridicalPersonDto"
          },
          "tariff_id": {
            "type": "integer",
            "description": "ID тарифа",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "PostOrderResponseDto": {
        "type": "object",
        "properties": {
          "order_id": {
            "type": "integer",
            "description": "ID нового заказа",
            "format": "int32",
            "nullable": true
          },
          "invoice_id": {
            "type": "integer",
            "description": "ID нового счета",
            "format": "int32",
            "nullable": true
          },
          "invoice_url": {
            "type": "string",
            "description": "Публичная короткая ссылка на счет",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "PostSslOrderRequestDto": {
        "required": [
          "tariff_id"
        ],
        "type": "object",
        "properties": {
          "period_unit_count": {
            "type": "integer",
            "description": "Период оплаты",
            "format": "int32",
            "nullable": true
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32",
            "nullable": true
          },
          "phone": {
            "type": "string",
            "description": "Телефон",
            "nullable": true
          },
          "email": {
            "type": "string",
            "description": "Почта",
            "nullable": true
          },
          "natural_person_requisites": {
            "$ref": "#/components/schemas/NaturalPersonDto"
          },
          "individual_businessman_requisites": {
            "$ref": "#/components/schemas/IndividualBusinessmanDto"
          },
          "juridical_person_requisites": {
            "$ref": "#/components/schemas/JuridicalPersonDto"
          },
          "tariff_id": {
            "type": "integer",
            "description": "ID тарифа",
            "format": "int32"
          },
          "domain": {
            "type": "string",
            "description": "Домен",
            "nullable": true
          },
          "csr": {
            "type": "string",
            "description": "CSR",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO запроса"
      },
      "PriceDto": {
        "required": [
          "period",
          "price"
        ],
        "type": "object",
        "properties": {
          "period": {
            "type": "integer",
            "description": "Период оплаты",
            "format": "int32"
          },
          "price": {
            "type": "number",
            "description": "Стоимость",
            "format": "double"
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "ServiceDto": {
        "required": [
          "canonical_name",
          "name",
          "service_id"
        ],
        "type": "object",
        "properties": {
          "service_id": {
            "type": "string",
            "description": "ID услуги",
            "nullable": true
          },
          "canonical_name": {
            "type": "string",
            "description": "Каноническое наименование",
            "nullable": true
          },
          "name": {
            "type": "string",
            "description": "Наименование",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "SslOrderAdvancedDto": {
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "Домен",
            "nullable": true
          },
          "use_csr": {
            "type": "boolean",
            "description": "Признак использования пользовательского CSR",
            "nullable": true
          },
          "tariff_id": {
            "type": "integer",
            "description": "Тариф (наименование SSL-сертификата)",
            "format": "int32",
            "nullable": true
          },
          "valid_from_date": {
            "type": "string",
            "description": "Дата начала действия сертификата",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "valid_till_date": {
            "type": "string",
            "description": "Дата окончания действия сертификата",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "SslOrderDto": {
        "required": [
          "business_entity_type",
          "completed",
          "currency_id",
          "number",
          "order_datetime",
          "order_id",
          "paid",
          "period_unit_count",
          "period_unit_type",
          "service_id",
          "state"
        ],
        "type": "object",
        "properties": {
          "order_id": {
            "type": "integer",
            "description": "ID заказа",
            "format": "int32"
          },
          "service_id": {
            "type": "integer",
            "description": "ID услуги",
            "format": "int32"
          },
          "number": {
            "type": "string",
            "description": "Номер заказа",
            "nullable": true
          },
          "state": {
            "type": "string",
            "description": "Статус услуги",
            "nullable": true
          },
          "order_datetime": {
            "type": "string",
            "description": "Дата оформления заказа",
            "format": "date-time"
          },
          "complete_date": {
            "type": "string",
            "description": "Дата выполнения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "expiration_date": {
            "type": "string",
            "description": "Дата истечения заказа",
            "format": "date",
            "nullable": true,
            "example": "01.01.2000"
          },
          "currency_id": {
            "type": "integer",
            "description": "ID валюты",
            "format": "int32"
          },
          "period_unit_type": {
            "type": "string",
            "description": "Тип периода оплаты",
            "nullable": true
          },
          "period_unit_count": {
            "type": "integer",
            "description": "Количество единиц периода оплаты",
            "format": "int32"
          },
          "paid": {
            "type": "boolean",
            "description": "Статус оплаты"
          },
          "completed": {
            "type": "boolean",
            "description": "Статус выполнения"
          },
          "business_entity_type": {
            "type": "string",
            "description": "Тип заказчика в реквизитах",
            "nullable": true
          },
          "advanced": {
            "$ref": "#/components/schemas/SslOrderAdvancedDto"
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      },
      "TariffDto": {
        "required": [
          "period_type",
          "prices",
          "service_id",
          "tariff_id",
          "tariff_name"
        ],
        "type": "object",
        "properties": {
          "tariff_id": {
            "type": "integer",
            "description": "ID тарифа",
            "format": "int32"
          },
          "tariff_name": {
            "type": "string",
            "description": "Название тарифа",
            "nullable": true
          },
          "service_id": {
            "type": "string",
            "description": "Общее имя услуги",
            "nullable": true
          },
          "period_type": {
            "type": "string",
            "description": "Период оплаты",
            "nullable": true
          },
          "prices": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PriceDto"
            },
            "description": "Стоимость",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "DTO ответа"
      }
    }
  },
  "tags": [
    {
      "name": "OrderApi",
      "description": "API для работы с заказами"
    }
  ]
}