Castles:Защита серверов/API защиты серверов - История изменений

Swidh в 14:26, 15 января 2025

2025-01-15T14:26:42Z

← Предыдущая		Версия 14:26, 15 января 2025
Строка 154:		Строка 154:
	"enduser": "user123"		"enduser": "user123"
	}		}

			Примечание: поле ipAddress в json не обязательно (по умолчанию равно <ip_address> из URL строки)

	Пример запроса:		Пример запроса:
Строка 208:		Строка 210:
	{		{
	"game":"ark",		"game":"ark",
			"ipAddress": "10.10.10.5",
	"ports": {		"ports": {
	"game": 27020,		"game": 27020,
Строка 216:		Строка 219:
	}		}

	main_port - это адрес зарегистрированного главного порта сервера. Т.е. если main_port меняется - это должно быть старое значение.		main_port - это адрес зарегистрированного главного порта сервера. Т.е. если main_port меняется - это должно быть старое значение, аналогично у <ip_address>/ipAddress (в ipAddress указывается новый адрес, в ip_address - старый).

	При изменении одного из портов или game, выполнение запроса вызовет полное удаление из-под защиты сервера, с последующим добавлением под защиту под новыми портами (аналогично последовательному вызову GET/DELETE/POST).		При изменении одного из портов или game, выполнение запроса вызовет полное удаление из-под защиты сервера, с последующим добавлением под защиту под новыми портами (аналогично последовательному вызову GET/DELETE/POST).

Swidh в 08:53, 10 января 2025

2025-01-10T08:53:07Z

← Предыдущая		Версия 08:53, 10 января 2025
Строка 201:		Строка 201:
	* HTTP 400 The port must be in the range 1-65535.		* HTTP 400 The port must be in the range 1-65535.
	* HTTP 404 Server not found.		* HTTP 404 Server not found.
			* HTTP 503 Service Unavailable

			== Обновление сервера под защитой (перспективный запрос) ==
			'''PUT [baseUrl]/[project]/v2/<ip_address>/<main_port>'''
			Тело запроса:
			{
			"game":"ark",
			"ports": {
			"game": 27020,
			"query": 27015,
			"rcon": 27100
			},
			"enduser": "user123"
			}

			main_port - это адрес зарегистрированного главного порта сервера. Т.е. если main_port меняется - это должно быть старое значение.

			При изменении одного из портов или game, выполнение запроса вызовет полное удаление из-под защиты сервера, с последующим добавлением под защиту под новыми портами (аналогично последовательному вызову GET/DELETE/POST).

			Пример запроса:
			curl -d '{"game":"ark","ports":{"game":27020,"query":27015,"rcon":27100},"enduser":"uid=123"}' -H "Content-Type: application/json" -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X PUT https://api.castles.pro/myhost/v2/89.22.249.11/27020 -k -v

			Пример ответа:
			{
			"game": "ark",
			"ipAddress": "89.22.249.11",
			"enduser": "uid=123",
			"ports": {
			"query": 27015,
			"game": 27020,
			"rcon": 27100
			},
			"protection": {
			"status": "online",
			"address": "89.22.249.11/27020",
			"additional": "query:27015, rcon:27100",
			"comment": "Защита игрового сервера"
			}
			}

			Возвращаемые ошибки:
			* HTTP 400 Request must contain a valid IP.
			* HTTP 400 Body must contain valid json.
			* HTTP 400 The game field is required.
			* HTTP 400 The ports[] field is required.
			* HTTP 400 Game not found.
			* HTTP 400 The <port_id> port is required.
			* HTTP 400 The <port_id> port must be in the range 1-65535.
			* HTTP 400 The <ip>:<port> is overlaps with current servers.
	* HTTP 503 Service Unavailable		* HTTP 503 Service Unavailable

Swidh в 22:19, 22 ноября 2023

2023-11-22T22:19:12Z

← Предыдущая		Версия 22:19, 22 ноября 2023
Строка 23:		Строка 23:
	'''GET [baseUrl]/[project]/v2/<ip_address>/<main_port>'''		'''GET [baseUrl]/[project]/v2/<ip_address>/<main_port>'''
	Пример запроса:		Пример запроса:
	curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/~~arkhoster~~/v2/89.22.249.11/27020 -k -v		curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/myhost/v2/89.22.249.11/27020 -k -v

	Пример ответа:		Пример ответа:
Строка 52:		Строка 52:
	'''GET [baseUrl]/[project]/v2/<ip_address>'''		'''GET [baseUrl]/[project]/v2/<ip_address>'''
	Пример запроса:		Пример запроса:
	curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/~~arkhoster~~/v2/89.22.249.11 -k -v		curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/myhost/v2/89.22.249.11 -k -v

	Пример ответа:		Пример ответа:
Строка 96:		Строка 96:
	'''GET [baseUrl]/[project]/v2?start=<start>&length=<length>&endUser=<endUser>'''		'''GET [baseUrl]/[project]/v2?start=<start>&length=<length>&endUser=<endUser>'''
	Пример запроса:		Пример запроса:
	curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/~~arkhoster~~/v2?start=0&length=2&endUser=user123 -k -v		curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/myhost/v2?start=0&length=2&endUser=user123 -k -v

	Пример ответа:		Пример ответа:
Строка 156:		Строка 156:

	Пример запроса:		Пример запроса:
	curl -d '{"game":"ark","ports":{"game":27020,"query":27015,"rcon":27100},"enduser":"uid=123"}' -H "Content-Type: application/json" -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X POST https://api.castles.pro/~~arkhoster~~/v2/89.22.249.11 -k -v		curl -d '{"game":"ark","ports":{"game":27020,"query":27015,"rcon":27100},"enduser":"uid=123"}' -H "Content-Type: application/json" -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X POST https://api.castles.pro/myhost/v2/89.22.249.11 -k -v

	Пример ответа:		Пример ответа:
Строка 190:		Строка 190:
	'''DELETE [baseUrl]/[project]/v2/<ip_address>/<main_port>'''		'''DELETE [baseUrl]/[project]/v2/<ip_address>/<main_port>'''
	Пример запроса:		Пример запроса:
	curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X DELETE https://api.castles.pro/~~arkhoster~~/v2/89.22.249.11/27020 -k -v		curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X DELETE https://api.castles.pro/myhost/v2/89.22.249.11/27020 -k -v

	Пример ответа:		Пример ответа:
Строка 218:		Строка 218:
	'''GET [baseUrl]/[project]/v2/games'''		'''GET [baseUrl]/[project]/v2/games'''
	Пример запроса:		Пример запроса:
	curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/~~arkhoster~~/v2/games -k -v		curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/myhost/v2/games -k -v

	Пример ответа:		Пример ответа:
Строка 242:		Строка 242:
	'''GET [baseUrl]/[project]/v2/network'''		'''GET [baseUrl]/[project]/v2/network'''
	Пример запроса:		Пример запроса:
	curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/~~arkhoster~~/v2/network -k -v		curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/myhost/v2/network -k -v

	Пример ответа:		Пример ответа:

Swidh: /* Добавление сервера под защиту */

2023-11-07T16:45:07Z

Добавление сервера под защиту

← Предыдущая		Версия 16:45, 7 ноября 2023
Строка 143:		Строка 143:

	== Добавление сервера под защиту ==		== Добавление сервера под защиту ==
	'''POST [baseUrl]/[project]/<ip_address>'''		'''POST [baseUrl]/[project]/v2/<ip_address>'''
	Тело запроса:		Тело запроса:
	{		{

Swidh: /* Просмотр данных сервера */

2023-11-07T16:29:12Z

Просмотр данных сервера

← Предыдущая		Версия 16:29, 7 ноября 2023
Строка 44:		Строка 44:

	Возвращаемые ошибки:		Возвращаемые ошибки:
			* HTTP 400 Request must contain a valid IP.
	* HTTP 404 Machine not found.		* HTTP 404 Machine not found.
			* HTTP 400 The port must be in the range 1-65535.
			* HTTP 404 Server not found.

	== Просмотр данных всех серверов на IP-адресе ==		== Просмотр данных всех серверов на IP-адресе ==

Swidh: /* Просмотр данных сервера */

2023-11-07T16:27:08Z

Просмотр данных сервера

← Предыдущая		Версия 16:27, 7 ноября 2023
Строка 44:		Строка 44:

	Возвращаемые ошибки:		Возвращаемые ошибки:
	* HTTP 400 Request must contain a valid IP.		* HTTP 404 Machine not found.
	* HTTP 400 The port must be in the range 1-65535.
	* HTTP 404 ~~Server~~ not found.

	== Просмотр данных всех серверов на IP-адресе ==		== Просмотр данных всех серверов на IP-адресе ==

Swidh: /* Просмотр данных всех серверов c пагинацией и фильтрацией по endUser */

2023-10-30T09:38:19Z

Просмотр данных всех серверов c пагинацией и фильтрацией по endUser

← Предыдущая		Версия 09:38, 30 октября 2023
Строка 93:		Строка 93:

	== Просмотр данных всех серверов c пагинацией и фильтрацией по endUser ==		== Просмотр данных всех серверов c пагинацией и фильтрацией по endUser ==
	'''GET [baseUrl]/[project]/v2?start=x&length=z&endUser=x'''		'''GET [baseUrl]/[project]/v2?start=<start>&length=<length>&endUser=<endUser>'''
	Пример запроса:		Пример запроса:
	curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/arkhoster/v2?start=0&length=2&endUser=user123 -k -v		curl -H "Authorization: Bearer nv73MHPHw3!eEVzuHAlAhSZH/CenIgAN=/eccBIuK2AlwHF4aYSrsV3EZnMkmo-V" -X GET https://api.castles.pro/arkhoster/v2?start=0&length=2&endUser=user123 -k -v

Swidh: /* Просмотр данных всех серверов c пагинацией и фильтрацией по endUser */

2023-10-30T09:23:07Z

Просмотр данных всех серверов c пагинацией и фильтрацией по endUser

← Предыдущая		Версия 09:23, 30 октября 2023
Строка 138:		Строка 138:

	Возвращаемые ошибки:		Возвращаемые ошибки:
	* HTTP 400 ~~Request~~ must contain a ~~valid IP~~.		* HTTP 400 The start field must contain a number greater than or equal to 0.
			* HTTP 400 The length field must contain a number greater than 0.

	== Добавление сервера под защиту ==		== Добавление сервера под защиту ==

Swidh: /* Просмотр данных всех серверов c пагинацией и фильтрацией по endUser */

2023-10-30T09:20:19Z

Просмотр данных всех серверов c пагинацией и фильтрацией по endUser

← Предыдущая		Версия 09:20, 30 октября 2023
Строка 132:		Строка 132:
	}		}
	}		}
	]		],
	"total_count": 100		"total_count": 100
	}		}

Swidh: /* Просмотр данных всех серверов c пагинацией и фильтрацией по endUser */

2023-10-30T09:18:43Z

Просмотр данных всех серверов c пагинацией и фильтрацией по endUser

← Предыдущая		Версия 09:18, 30 октября 2023
Строка 98:		Строка 98:

	Пример ответа:		Пример ответа:
	{		{
	"rows": [		"rows": [
	{		{
Строка 134:		Строка 134:
	]		]
	"total_count": 100		"total_count": 100
	}		}