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

copy

URL de solicitud para la acción de descarga

GET

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

copy

project_id

Numerical

El ID único del proyecto

Parámetros de consulta

bucket_name Alphanumeric

mandatory

El nombre del 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

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
copy

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
copy

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

View more

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit