Skip to navigation
business.me-mate.net APIs Document V 1.0Messenger Mate Gallery App File Upload Folder Management APIFile Upload Ap Is

Get Download URL

View as Markdown

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:
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:

VariableRequiredDescription
base_urlYesBase API URL (e.g. https://business.me-mate.net/partners/wp-gallery/manage)
access_tokenYesAccess token used to authorize the request
file_idYesID of the file to generate the download URL for

Path Parameters

ParameterTypeRequiredDescription
file_idintegerYesUnique identifier of the file

Example request URL:

{{base_url}}/files/34/download

Sample request

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.

{
  "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

FieldTypeDescription
download_urlstringTemporary 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.

Response

OK
dataobject
successboolean