com.sinch.sdk.domains.verification.models.dto.v1.InitiateVerificationResponseCalloutDto Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of sinch-sdk-java Show documentation
Show all versions of sinch-sdk-java Show documentation
SDK providing a Java API for the Sinch REST APIs.
/*
* Verification
* Verification REST API for verifying phone numbers and users. Support of FlashCall verification, PIN SMS verification and Callout verification. **Note:** OTP CODE must be the full valid E.164 number that we called from. ## Overview For general information on how to use the Sinch APIs including methods, types, errors and authorization, please check the [Using REST](doc:using-rest) page. Use the Sinch Verification Service to verify end-user's mobile phone numbers. The Sinch Verification APIs should be used in combination with the Verification SDKs for a complete end-to-end solution, though it is possible to only use the APIs. Currently, there are three verification methods supported: - FlashCall verification - Android only - PIN SMS verification - iOS, Android, Javascript - Callout verification (voice call) - iOS only - Data verification (distinguished by method = `seamless`) - iOS, Android #### FlashCall verification With the flashCall verification method, a user's phone number is verified by triggering a \"missed call\" towards this number. The call is intercepted by the Android SDK in the mobile app and blocked automatically. To initiate a flashCall verification, check the [Android SDK documentation](doc:verification-android-the-verification-process#flash-call-verification). For additional security, it is recommended that you control which verification requests should proceed and which ones not, by listening in your backend for the [Verification Request Event](doc:verification-rest-verification-api#verification-request) and respond accordingly. Your backend will be notified on the result of the verification with the [Verification Result Event](doc:verification-rest-callback-api#verification-result-event). #### PIN SMS verification With the PIN SMS verification method, a user's phone number is verified by sending an SMS containing a PIN code to this number. In the case of iOS or Javascript, the user needs to enter the PIN manually in the app, while for Android there is an option of intercepting the SMS message delivery and capturing the PIN code automatically. To initiate a PIN SMS verification, check the [iOS](doc:verification-ios-sms-verification), [Android](doc:verification-for-android) and [Javascript](doc:verification-for-javascript) documentation. For additional security, it is recommended that you control which verification requests should proceed and which ones not, by listening in your backend for the [Verification Request Event](doc:verification-rest-verification-api#verification-request) and respond accordingly. Your backend will be notified on the result of the verification with the [Verification Result Event](doc:verification-rest-callback-api#verification-result-event). #### Callout verification With the callout verification method, a user's phone number is verified by receiving a phone call and hearing a pre-recorded or text-to-speech message, advising the user to press a digit code. When the user presses the digit code in the dialpad, the verification is successful. To initiate a callout verification, check the [iOS documentation](doc:verification-ios-callout-verification). For additional security, it is recommended that you control which verification requests should proceed and which ones not, by listening in your backend for the [Verification Request Event](doc:verification-rest-verification-api#verification-request) and respond accordingly. Your backend will be notified on the result of the verification with the [Verification Result Event](doc:verification-rest-callback-api#verification-result-event). #### Data verification With the data verification method, a user's phone number is verified by carrier using mobile data network. For additional security, it is recommended that you control which verification requests should proceed and which ones not, by listening in your backend for the [Verification Request Event](doc:verification-rest-verification-api#verification-request) and respond accordingly. Your backend will be notified on the result of the verification with the [Verification Result Event](doc:verification-rest-callback-api#verification-result-event). > 📘 For information about webhooks and the verifications events [Callbacks](/docs/verification-rest-callback-api).
*
* The version of the OpenAPI document: 1.0.0
* Contact: [email protected]
*
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
* https://openapi-generator.tech
* Do not edit the class manually.
*/
package com.sinch.sdk.domains.verification.models.dto.v1;
import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.core.JsonToken;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonMappingException;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.MapperFeature;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
import com.fasterxml.jackson.databind.ser.std.StdSerializer;
import com.sinch.sdk.core.models.AbstractOpenApiSchema;
import com.sinch.sdk.core.utils.databind.JSONNavigator;
import java.io.IOException;
import java.util.Collections;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.logging.Level;
import java.util.logging.Logger;
@JsonDeserialize(
using =
InitiateVerificationResponseCalloutDto.InitiateVerificationResponseCalloutDtoDeserializer
.class)
@JsonSerialize(
using =
InitiateVerificationResponseCalloutDto.InitiateVerificationResponseCalloutDtoSerializer
.class)
public final class InitiateVerificationResponseCalloutDto extends AbstractOpenApiSchema {
private static final Logger log =
Logger.getLogger(InitiateVerificationResponseCalloutDto.class.getName());
public static final class InitiateVerificationResponseCalloutDtoSerializer
extends StdSerializer {
private static final long serialVersionUID = 1L;
public InitiateVerificationResponseCalloutDtoSerializer(
Class t) {
super(t);
}
public InitiateVerificationResponseCalloutDtoSerializer() {
this(null);
}
@Override
public void serialize(
InitiateVerificationResponseCalloutDto value,
JsonGenerator jgen,
SerializerProvider provider)
throws IOException, JsonProcessingException {
jgen.writeObject(value.getActualInstance());
}
}
public static final class InitiateVerificationResponseCalloutDtoDeserializer
extends StdDeserializer {
private static final long serialVersionUID = 1L;
public InitiateVerificationResponseCalloutDtoDeserializer() {
this(InitiateVerificationResponseCalloutDto.class);
}
public InitiateVerificationResponseCalloutDtoDeserializer(Class vc) {
super(vc);
}
@Override
public InitiateVerificationResponseCalloutDto deserialize(
JsonParser jp, DeserializationContext ctxt) throws IOException, JsonProcessingException {
JsonNode tree = jp.readValueAsTree();
Object deserialized = null;
boolean typeCoercion = ctxt.isEnabled(MapperFeature.ALLOW_COERCION_OF_SCALARS);
int match = 0;
JsonToken token = tree.traverse(jp.getCodec()).nextToken();
// deserialize CalloutInitiateVerificationResponseDto
try {
boolean attemptParsing = true;
// ensure that we respect type coercion as set on the client ObjectMapper
if (CalloutInitiateVerificationResponseDto.class.equals(Integer.class)
|| CalloutInitiateVerificationResponseDto.class.equals(Long.class)
|| CalloutInitiateVerificationResponseDto.class.equals(Float.class)
|| CalloutInitiateVerificationResponseDto.class.equals(Double.class)
|| CalloutInitiateVerificationResponseDto.class.equals(Boolean.class)
|| CalloutInitiateVerificationResponseDto.class.equals(String.class)) {
attemptParsing = typeCoercion;
if (!attemptParsing) {
attemptParsing |=
((CalloutInitiateVerificationResponseDto.class.equals(Integer.class)
|| CalloutInitiateVerificationResponseDto.class.equals(Long.class))
&& token == JsonToken.VALUE_NUMBER_INT);
attemptParsing |=
((CalloutInitiateVerificationResponseDto.class.equals(Float.class)
|| CalloutInitiateVerificationResponseDto.class.equals(Double.class))
&& token == JsonToken.VALUE_NUMBER_FLOAT);
attemptParsing |=
(CalloutInitiateVerificationResponseDto.class.equals(Boolean.class)
&& (token == JsonToken.VALUE_FALSE || token == JsonToken.VALUE_TRUE));
attemptParsing |=
(CalloutInitiateVerificationResponseDto.class.equals(String.class)
&& token == JsonToken.VALUE_STRING);
attemptParsing |= (token == JsonToken.VALUE_NULL);
}
}
if (attemptParsing) {
deserialized =
tree.traverse(jp.getCodec())
.readValueAs(CalloutInitiateVerificationResponseDto.class);
// TODO: there is no validation against JSON schema constraints
// (min, max, enum, pattern...), this does not perform a strict JSON
// validation, which means the 'match' count may be higher than it should be.
match++;
log.log(
Level.FINER, "Input data matches schema 'CalloutInitiateVerificationResponseDto'");
}
} catch (Exception e) {
// deserialization failed, continue
log.log(
Level.FINER,
"Input data does not match schema 'CalloutInitiateVerificationResponseDto'",
e);
}
if (match == 1) {
InitiateVerificationResponseCalloutDto ret = new InitiateVerificationResponseCalloutDto();
ret.setActualInstance(deserialized);
return ret;
}
throw new IOException(
String.format(
"Failed deserialization for InitiateVerificationResponseCalloutDto: %d classes match"
+ " result, expected 1",
match));
}
/** Handle deserialization of the 'null' value. */
@Override
public InitiateVerificationResponseCalloutDto getNullValue(DeserializationContext ctxt)
throws JsonMappingException {
return null;
}
}
// store a list of schema names defined in oneOf
public static final Map> schemas = new HashMap<>();
public InitiateVerificationResponseCalloutDto() {
super("oneOf", Boolean.TRUE);
}
public InitiateVerificationResponseCalloutDto(CalloutInitiateVerificationResponseDto o) {
super("oneOf", Boolean.TRUE);
setActualInstance(o);
}
static {
schemas.put(
"CalloutInitiateVerificationResponseDto", CalloutInitiateVerificationResponseDto.class);
JSONNavigator.registerDescendants(
InitiateVerificationResponseCalloutDto.class, Collections.unmodifiableMap(schemas));
}
@Override
public Map> getSchemas() {
return InitiateVerificationResponseCalloutDto.schemas;
}
/**
* Set the instance that matches the oneOf child schema, check the instance parameter is valid
* against the oneOf child schemas: CalloutInitiateVerificationResponseDto
*
* It could be an instance of the 'oneOf' schemas. The oneOf child schemas may themselves be a
* composed schema (allOf, anyOf, oneOf).
*/
@Override
public void setActualInstance(Object instance) {
if (instance == null) {
super.setActualInstance(instance);
return;
}
if (JSONNavigator.isInstanceOf(
CalloutInitiateVerificationResponseDto.class, instance, new HashSet>())) {
super.setActualInstance(instance);
return;
}
throw new RuntimeException(
"Invalid instance type. Must be CalloutInitiateVerificationResponseDto");
}
/**
* Get the actual instance, which can be the following: CalloutInitiateVerificationResponseDto
*
* @return The actual instance (CalloutInitiateVerificationResponseDto)
*/
@Override
public Object getActualInstance() {
return super.getActualInstance();
}
/**
* Get the actual instance of `CalloutInitiateVerificationResponseDto`. If the actual instance is
* not `CalloutInitiateVerificationResponseDto`, the ClassCastException will be thrown.
*
* @return The actual instance of `CalloutInitiateVerificationResponseDto`
* @throws ClassCastException if the instance is not `CalloutInitiateVerificationResponseDto`
*/
public CalloutInitiateVerificationResponseDto getCalloutInitiateVerificationResponseDto()
throws ClassCastException {
return (CalloutInitiateVerificationResponseDto) super.getActualInstance();
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy