调用GetOssPolicy接口获取上传凭据,用于向指定子场景上传全景图片或全景视频

获取上传凭据后请参考服务端签名后直传流程上传文件,上传后调用关联图片到子场景接口关联图片到子场景。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String GetOssPolicy

系统规定参数。取值:GetOssPolicy

SubSceneId String 1234****

子场景ID

返回数据

名称 类型 示例值 描述
RequestId String 4F882EA7-3A1D-0113-94E4-70162C4****

请求ID,与入参requestId对应

Code Long 200

返回码

Success Boolean true

是否请求成功

Message String success

错误消息

AccessId String abc

accessId,OSS SDK上传时参数,对应OSSAccessKeyId

Policy String def

授权,OSS SDK上传时参数,对应policy

Signature String ghi

签名,OSS SDK上传时参数,对应signature

Dir String 123/

授权路径,OSS SDK上传时参数,需要拼接文件名后使用, ${DIR}/xxx.jpg对应key

Host String oss.aliyun.com

上传地址, OSS SDK上传时的请求地址

Expire String 60

授权失效时间(s),可以判断授权是否在有效期内,失效后授权不可用

Callback String ""

上传回调,保留字段,目前未使用

示例

请求示例

Config config = new Config();
        config.setAccessKeyId("yourAccessKeyId");
        config.setAccessKeySecret("yourAccessKeySecret");
        config.setEndpoint("lyj.cn-hangzhou.aliyuncs.com");

        Client client = new Client(config);

        GetOssPolicyRequest request = new GetOssPolicyRequest();
        request.setSubSceneId(“1234***”);

        GetOssPolicyResponse response = client.getOssPolicy(request);
        if (response.getBody().success){
            // ...
        }

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetOssPolicyResponse>
    <RequestId>4F882EA7-3A1D-0113-94E4-70162C4****</RequestId>
    <Code>200</Code>
    <Success>true</Success>
    <Message>success</Message>
    <AccessId>abc</AccessId>
    <Policy>def</Policy>
    <Signature>ghi</Signature>
    <Dir>123/</Dir>
    <Host>oss.aliyun.com</Host>
    <Expire>60</Expire>
    <Callback>""</Callback>
</GetOssPolicyResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "4F882EA7-3A1D-0113-94E4-70162C4****",
  "Code" : 200,
  "Success" : true,
  "Message" : "success",
  "AccessId" : "abc",
  "Policy" : "def",
  "Signature" : "ghi",
  "Dir" : "123/",
  "Host" : "oss.aliyun.com",
  "Expire" : "60",
  "Callback" : "\"\""
}

错误码

访问错误中心查看更多错误码。