com.sinch.sdk.domains.voice.WebHooksService 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

SDK providing a Java API for the Sinch REST APIs.

There is a newer version: 1.4.0

package com.sinch.sdk.domains.voice;

import com.sinch.sdk.core.exceptions.ApiMappingException;
import com.sinch.sdk.domains.voice.models.svaml.SVAMLControl;
import com.sinch.sdk.domains.voice.models.webhooks.WebhooksEvent;
import java.util.Map;

/**
 * Webhooks service
 *
 * @see https://developers.sinch.com/docs/voice/api-reference/voice/tag/Callbacks/
 * @since 1.0
 */
public interface WebHooksService {

  /**
   * 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
   *
   * @param method The HTTP method used ot handle the callback
   * @param path The path to you backend endpoint used for callback
   * @param headers Received headers
   * @param jsonPayload Received payload
   * @return Is authentication is validated (true) or not (false)
   *     
see https://developers.sinch.com/docs/voice/api-reference/authentication/callback-signed-request/
   * @since 1.0
   */
  boolean validateAuthenticatedRequest(
      String method, String path, Map headers, String jsonPayload);

  /**
   * This function can be called to deserialize received payload onto callback onto proper java
   * Voice event class
   *
   * @param jsonPayload Received payload to be deserialized
   * @return The Voice event instance class
   *     
see https://developers.sinch.com/docs/voice/api-reference/voice/tag/Callbacks/
   * @since 1.0
   */
  WebhooksEvent unserializeWebhooksEvent(String jsonPayload) throws ApiMappingException;

  /**
   * This function can be called to serialize a Voice response to be sent as JSON
   *
   * @param response The response to be serialized
   * @return The JSON string to be sent
   *     see https://developers.sinch.com/docs/voice/api-reference/voice/tag/Callbacks/
   * @since 1.0
   */
  String serializeWebhooksResponse(SVAMLControl response) throws ApiMappingException;
}