Get Signed URL API

This API is designed to provide secure access to call recordings by generating a signed URL that expires after a set duration.

Endpoint Description

POST https://outgoing-call.alohaa.ai/v1/external/get-signed-url

Parameters

Request Headers

Field	Value	Description	Mandatory
Content-Type	application/json	Specifies the content type of the request.	Yes
x-metro-api-key	*************************	API key for authentication purposes.	Yes

Request Body

Field	Data Type	Description	Mandatory
document_id	String	The identifier for the document (audio file) to access, typically retrieved from call logs.	Yes

Sample Request

Request Header

{
  "x-metro-api-key": "****************"
}

Request Body

Responses

Success Response

{
  "success": true,
  "response": {
    "status": "Call Record URL",
    "url": "https://doosra-ivr-voicemails.s3.ap-south-1.amazonaws.com/ten20_infomedia/DIA84b497d10d98ae74fd30010cf35aa612.mp3?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIASRCTKU3YZEGOE5TG%2F20231016%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20231016T105844Z&X-Amz-Expires=604800&X-Amz-Signature=ef1d313a20fcb2032803952122c2a1306db7551efc716cbf81be3d7c74268f78&X-Amz-SignedHeaders=host"
  }
}

Failure Response

{
  "success": false,
  "error": {
    "code": 1099,
    "reason": "Invalid schema or Missing Data sent"
  }
}

Error Codes

Code	Description
1025	Audio file not found
1099	Invalid schema or Missing Data sent