libkazv
Kazv::Api::RequestMsisdnValidation Struct Reference

#include <request_msisdn_validation.hpp>

Inheritance diagram for Kazv::Api::RequestMsisdnValidation:

Public Attributes

std::string clientSecret
 A unique string generated by the client, and used to identify the validation attempt. More...
 
std::string country
 The two-letter uppercase ISO-3166-1 alpha-2 country code that the number in phone_number should be parsed as if it were dialled from. More...
 
std::string phoneNumber
 The phone number to validate. More...
 
int sendAttempt
 The server will only send an SMS if the send_attempt is a number greater than the most recent one which it has seen, scoped to that country + phone_number + client_secret triple. More...
 
std::optional< std::string > nextLink
 Optional. More...
 

Member Data Documentation

◆ clientSecret

std::string Kazv::Api::RequestMsisdnValidation::clientSecret

A unique string generated by the client, and used to identify the validation attempt.

It must be a string consisting of the characters [0-9a-zA-Z.=_-]. Its length must not exceed 255 characters and it must not be empty.

◆ country

std::string Kazv::Api::RequestMsisdnValidation::country

The two-letter uppercase ISO-3166-1 alpha-2 country code that the number in phone_number should be parsed as if it were dialled from.

◆ nextLink

std::optional<std::string> Kazv::Api::RequestMsisdnValidation::nextLink

Optional.

When the validation is completed, the identity server will redirect the user to this URL. This option is ignored when submitting 3PID validation information through a POST request.

◆ phoneNumber

std::string Kazv::Api::RequestMsisdnValidation::phoneNumber

The phone number to validate.

◆ sendAttempt

int Kazv::Api::RequestMsisdnValidation::sendAttempt

The server will only send an SMS if the send_attempt is a number greater than the most recent one which it has seen, scoped to that country + phone_number + client_secret triple.

This is to avoid repeatedly sending the same SMS in the case of request retries between the POSTing user and the identity server. The client should increment this value if they desire a new SMS (e.g. a reminder) to be sent.


The documentation for this struct was generated from the following file: