backend/source/api/actions/meta_ping.ts

/*
Espe | Ein schlichtes Werkzeug zur Mitglieder-Verwaltung | Backend
Copyright (C) 2024 Christian Fraß

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public 
License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later 
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied 
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see 
<https://www.gnu.org/licenses/>. 
 */

namespace _espe.api
{
	
	/**
	 */
	export function register_meta_ping(
		rest_subject : lib_plankton.rest_http.type_rest
	) : void
	{
		lib_plankton.rest_http.register<
			null,
			string
		>
		(
			rest_subject,
			lib_plankton.http.enum_method.get,
			_espe.conf.get().server.path_base + "/meta/ping",
			{
				"description": () => "sendet ein 'pong' zurück; gedacht um die Erreichbarkeit des Backends zu prüfen",
				"input_schema": () => ({
					"nullable": true,
				}),
				"output_schema": () => ({
					"nullable": false,
					"type": "string",
				}),
				"restriction": () => restriction_none,
				"execution": () => () => {
					return Promise.resolve({
						"status_code": 200,
						"data": "pong",
					});
				},
			}
		);
	}
	
}