Package com.sinch.sdk.domains.voice.api.v1

Interface WebHooksService

public interface WebHooksService

Webhooks service

Since:

1.4

See Also:

• https://developers.sinch.com/docs/voice/api-reference/voice/tag/Callbacks/

Method Summary

Modifier and Type	Method	Description
VoiceWebhookEvent	parseEvent(String jsonPayload)	This function can be called to deserialize received payload onto callback onto proper java Voice event class
String	serializeResponse(SvamlControl response)	This function can be called to serialize a Voice response to be sent as JSON
boolean	validateAuthenticationHeader(String method, String path, Map<String,String> headers, String jsonPayload)	The Sinch Platform can initiate callback requests to a URL you define (Callback URL) on request and result events.

Method Details

validateAuthenticationHeader

boolean validateAuthenticationHeader(String method,
 String path,
 Map<String,String> headers,
 String jsonPayload)

The Sinch Platform can initiate callback requests to a URL you define (Callback URL) on request and result events. All callback requests are signed using your Application key and secret pair found on your dashboard. The signature is included in the Authorization header of the request

By using following function, you can ensure authentication according to received payload from your backend

Parameters:

method - The HTTP method used ot handle the callback

path - The path to you backend endpoint used for callback

headers - Received headers

jsonPayload - Received payload

Returns:

Is authentication is validated (true) or not (false)

see https://developers.sinch.com/docs/voice/api-reference/authentication/callback-signed-request/

Since:

1.4

parseEvent

VoiceWebhookEvent parseEvent(String jsonPayload)
                      throws ApiMappingException

This function can be called to deserialize received payload onto callback onto proper java Voice event class

Parameters:

jsonPayload - Received payload to be deserialized

Returns:

The Voice event instance class

see https://developers.sinch.com/docs/voice/api-reference/voice/tag/Callbacks/

Throws:

ApiMappingException

Since:

1.4

serializeResponse

String serializeResponse(SvamlControl response)
                  throws ApiMappingException

This function can be called to serialize a Voice response to be sent as JSON

Parameters:

response - The response to be serialized

Returns:

The JSON string to be sent

see https://developers.sinch.com/docs/voice/api-reference/voice/tag/Callbacks/

Throws:

ApiMappingException

Since:

1.4