署名付きURLの取得

説明

このAPIは、署名付きURLを取得できるようにします。署名付きURLは、認証済みユーザーが非認証ユーザーと共有できるセキュアなURLです。このURLにより、非認証ユーザーにオブジェクトへの一時的なアクセス権限が付与されます。リンクの有効期限が切れた場合、このAPIを使用して必要なURLに再度署名する必要があります。

注意: アップロード操作とダウンロード操作では異なるリクエストメソッドがあります。

リクエスト詳細

アップロード操作のリクエストURL

PUT

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

copy

ダウンロード操作のリクエストURL

GET

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

copy

project_id

Numerical

プロジェクトの一意のID

クエリパラメータ

bucket_name Alphanumeric

mandatory

バケットの名前

object_key String

mandatory

必要なオブジェクトの完全な名前を含みます。

expiry_in_seconds Number

optional

秒単位の有効期限を含みます。この制限に達すると、署名付きURLは使用できなくなります。デフォルト値は3600です。

active_from Timestamp

optional

署名付きURLがいつからアクティブになるかのタイムスタンプを含みます。

version_id String

optional

このパラメータはGETリクエストURLでのみ使用できます。バージョンIDを含みます。

リクエストヘッダー

Authorization: Zoho-oauthtoken {oauth_token}

オプションヘッダー

CATALYST-ORG: {org_id}

Environment: Development

ダウンロードのスコープ

ZohoCatalyst.buckets.objects.READ

アップロードのスコープ

ZohoCatalyst.buckets.objects.CREATE

レスポンス詳細

正常に実行されると、レスポンスには署名付きURLが含まれます。

ダウンロード操作のリクエスト例
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”

アップロード操作のリクエスト例
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”

レスポンス例
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