Get Download URL

## Get Download URL Generates a **temporary signed download URL** for a specific file. **Method:** `GET` **URL:** `{{base_url}}/files/{{file_id}}/download` --- ## Authentication This endpoint requires authentication. - **Recommended:** Bearer token in the `Authorization` header: ``` http Authorization: Bearer {{access_token}} ``` Notes: - If your collection/folder already sets auth, this request can **inherit auth**. - Ensure `{{access_token}}` is a valid, non-expired token. --- ## Required variables Set these variables at the **environment** or **collection** level: | Variable | Required | Description | | --- | --- | --- | | `base_url` | Yes | Base API URL (e.g. `https://business.me-mate.net/partners/wp-gallery/manage`) | | `access_token` | Yes | Access token used to authorize the request | | `file_id` | Yes | ID of the file to generate the download URL for | --- ## Path Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `file_id` | integer | Yes | Unique identifier of the file | Example request URL: ``` {{base_url}}/files/34/download ``` --- ## Sample request ``` bash curl --request GET "{{base_url}}/files/{{file_id}}/download" \ --header "Authorization: Bearer {{access_token}}" ``` --- ## Sample success response A successful request typically returns **HTTP 200 OK**. ``` json { "success": true, "data": { "download_url": "https://business.me-mate.net/cdngallery/9f86443bd9f2ad28d1be4b62e8783e96720ec87a2ba86fcbeb5fc537483bf05b/files/9/IilyM1n82ClVahgh.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=KBJGD07BGCOFODLECTF4/20260310/eu-west-1/s3/aws4_request&X-Amz-Date=20260310T062115Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Signature=4f2345e82432a46a793b150df1366dd139f677956de7f7ad4d34eba6d4315601" } } ``` --- ## Response fields | Field | Type | Description | | --- | --- | --- | | `download_url` | string | Temporary signed URL used to download the file | --- ## Common errors - **400 Bad Request** - Invalid or missing `file_id` - **401 Unauthorized / 403 Forbidden** - Missing/invalid `Authorization` header - Expired `{{access_token}}` - **404 Not Found** - File with the given `file_id` does not exist --- ## Notes - The `download_url` is a **time-limited signed URL** generated by the storage provider. - The URL may **expire after a specific duration** (e.g., 1 hour). - This endpoint is useful when you want to **securely share a downloadable file without exposing direct storage paths**. - Once the URL expires, a new request to this endpoint is required to generate another download link.