---
title: "Obtener URL prefirmada"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/stratus/get-presigned-url/
description: "Esta API te permite obtener URLs prefirmadas. Puedes compartir esta URL con otros usuarios y ellos podrán realizar acciones de descarga y carga de forma segura."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# Obtener URL prefirmada

### Descripción

Esta API te permite obtener URLs prefirmadas. Las URLs prefirmadas son URLs seguras que los usuarios autenticados pueden compartir con sus usuarios no autenticados. Esta URL proporcionará a los usuarios no autenticados autorización temporal para acceder a objetos. Una vez que el enlace expire, necesitas firmar la URL requerida nuevamente usando esta API.

> **Nota:** Hay diferentes métodos de solicitud para la acción de carga y la acción de descarga.

### Detalles de la solicitud

#### URL de solicitud para la acción de carga

`PUT` {api-domain}/baas/v1/project/{project_id}/bucket/object/signed-url

#### URL de solicitud para la acción de descarga

`GET` {api-domain}/baas/v1/project/{project_id}/bucket/object/signed-url

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

#### Parámetros de consulta

- **bucket_name** (Alphanumeric, mandatory): El [nombre del bucket](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)

- **object_key** (String, mandatory): Contendrá el nombre completo del objeto requerido.

- **expiry_in_seconds** (Number, optional): Contendrá el límite de tiempo en segundos. Una vez que se alcance este límite, la URL prefirmada no podrá ser utilizada. El valor predeterminado es `3600`

- **active_from** (Timestamp, optional): Contendrá la marca de tiempo a partir de cuándo la URL prefirmada estará activa.

- **version_id** (String, optional): Este parámetro solo se puede usar para la URL de solicitud `GET`. Contendrá el [ID de versión](https://docs.catalyst.zoho.com/es/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Alcance para descarga

ZohoCatalyst.buckets.objects.READ

#### Alcance para carga

ZohoCatalyst.buckets.objects.CREATE

### Detalles de la respuesta

Tras la ejecución exitosa, la respuesta contendrá la URL prefirmada.

**Sample Request For Download Action**

```bash

curl -X GET https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket/object/signed-url?bucket_name=myBucketName&object_key=object.pdf&expiry_in_seconds=3600&active_from=1716382375000&version_id=bs22sb2923ey2hds929/
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**Sample Request For Upload Action**

```bash

curl -X PUT https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket/object/signed-url?bucket_name=myBucketName&object_key=object.pdf&expiry_in_seconds=3600&active_from=1716382375000/
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**Sample Response**

```json

    {
    "status": "success",
    "data": {
        "signature": "https://mybucket.nimbuspop.com/folder1/folder2/image.jpeg?expires=1642915027000&signature=MEYCIQCcJDTsmZQhfuvFu3l3tsVL02uVwIMhLdlSg~ARI3E1aAIhAJ-rzzjn2gPH9pB3EoU3X~v~qvg5Rdt9OBoldBpVz6xt&key-id=vMUWDURn5DGtokPG",
        "expires_in_seconds": 300,
        "active_from": 1716382487000
    }
    }

```

### SDK Documentation

* [Generate Presigned URL - Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/stratus/pre-signed-urls/)
* [Generate Presigned URL - Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/stratus/pre-signed-urls/)
* [Generate Presigned URL - Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/stratus/pre-signed-urls/)
* [Stratus - Web SDK](https://docs.catalyst.zoho.com/es/sdk/web/v4/cloud-scale/stratus/overview/)
* [Stratus - iOS SDK](https://docs.catalyst.zoho.com/es/sdk/ios/v2/cloud-scale/stratus/overview/)
* [Stratus - Android SDK](https://docs.catalyst.zoho.com/es/sdk/android/v2/cloud-scale/stratus/overview/)
* [Stratus - Flutter SDK](https://docs.catalyst.zoho.com/es/sdk/flutter/v2/cloud-scale/stratus/overview/)