backend/source/api/actions/member_info.ts

namespace _espe.api
{
	
	/**
	 * @todo zeitliche Begrenzung?
	 */
	export function register_member_info(
		rest_subject : lib_plankton.rest.type_rest
	) : void
	{
		lib_plankton.rest.register<
			int,
			(
				null
				|
				{
					name_real_value : string;
					name_real_index : int;
					name_login : string;
					email_address_veiled : string;
					email_address_nominal : string;
				}
			)
		>(
			rest_subject,
			lib_plankton.http.enum_method.get,
			_espe.conf.get().server.path_base + "/member/info/:id",
			{
				"description": "gibt Angaben über ein Mitglied aus, die für die Registrierung verwendet werden dürfen",
				"input_schema": () => ({
					"type": "number",
					"nullable": false,
				}),
				"output_schema": () => ({
					"type": "object",
					"nullable": false,
					"additionalProperties": false,
					"properties": {
						"name_real_value": {
							"type": "string",
							"nullable": false,
						},
						"name_real_index": {
							"type": "number",
							"nullable": false,
						},
						"name_login": {
							"type": "string",
							"nullable": false,
						},
						"email_address_veiled": {
							"type": "string",
							"nullable": false,
						},
						"email_address_nominal": {
							"type": "string",
							"nullable": false,
						},
					},
					"required": [
						"name_real_value",
						"name_real_index",
						"name_login",
						"email_address_veiled",
						"email_address_nominal",
					]
				}),
				"query_parameters": [
					{
						"name": "key",
						"required": true,
						"description": "Zugriffs-Schlüssel",
					},
				],
				"restriction": restriction_verification(
					stuff => parseInt(stuff.path_parameters["id"]),
					stuff => stuff.query_parameters["key"]
				),
				"execution": async ({"path_parameters": path_parameters, "input": input}) => {
					const member_id : _espe.type.member_id = parseInt(path_parameters["id"]);
					const data : (
						null
						|
						{
							name_real_value : string;
							name_real_index : int;
							name_login : string;
							email_address_veiled : string;
							email_address_nominal : string;
						}
					) = await _espe.service.member.info(member_id);
					
					return Promise.resolve({
						"status_code": (
							(data === null)
							? 409
							: 200
						),
						"data": data
					});
				},
			}
		)
	}
	
}