namespace _espe.api
{
	
	/**
	 * @todo ausgeklügelte Durchsatzratenbegrenzung
	 * @todo captcha
	 */
	export function register_member_password_change_initialize(
		rest_subject : lib_plankton.rest.type_rest
	) : void
	{
		register<
			{
				identifier : string;
				url_template : string;
			},
			null
		>(
			rest_subject,
			lib_plankton.http.enum_method.post,
			"/member/password_change/initialize",
			{
				"description": "Versucht dem gegebenen Identifikator ein Mitglied zuzuordnen und sendet dem ermittelten Mitglied einen Passwort-Änderungs-Verweis an die hinterlegte private E-Mail-Adresse",
				"input_schema": () => ({
					"nullable": false,
					"type": "object",
					"properties": {
						"identifier": {
							"nullable": false,
							"type": "string",
							"description": "Anmelde-Name oder persönliche E-Mail-Adresse des Mitglieds"
						},
						"url_template": {
							"nullable": false,
							"type": "string",
							"description": "Schablone für URL; Platz-Halter: id,token"
						},
					},
					"additionalProperties": false,
					"required": [
						"identifier",
						"url_template",
					]
				}),
				"output_schema": () => ({
					"nullable": true
				}),
				"restriction": restriction_none,
				"execution": async ({"input": input}) => {
					await _espe.service.member.password_change_initialize(input.identifier, input.url_template);
					return Promise.resolve({
						"status_code": 200,
						"data": null
					});
				},
			}
		)
	}
	
}