获取上传凭据

调试

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

请求参数

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

系统规定参数。取值:CreateUploadPolicy

Type String scene

上传类型,值为:scene(场景)、subScene(子场景)、hotspot(后处理相关)

Option String {}

不同类型对应的参数

  • 上传场景数据包
    type: "scene", option: { "sceneld": "Td6HbmTJ****", "modelStyle":"PATCH" } 

    说明:modelStyle取 PATCH(2.5D模型)DEPTH(深度模型)

  • 上传子场景
     type: "subScene", option: { "subSceneld": "AZK5wcg****" }
  • 上传热点资源
    type: "hotspot", option: { "sceneld": "Td6HbmTJ****" "type": "IMAGE" } 

    说明:option中的type可以取IMAGE、 VIDEO、AUDIO、ICON

返回数据

名称 类型 示例值 描述
RequestId String B28A2ECB-AB29-1E01****

请求ID,与入参requestId对应

Code Long 200

返回码

Success Boolean true

是否请求成功

Message String SUCCESS

错误消息

Data Object

返回数据

AccessId String LTAI5t9k9****

accessId

Policy String eyJleHBpcmF0aW9uIjoiMj****

授权

Signature String KdnPJFIG25SM****

签名

Dir String dir/

授权路径

Host String oss.aliyun.com

上传地址

Expire String 1658812297

授权失效时间(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);

CreateUploadPolicyRequest request = new CreateUploadPolicyRequest();
request.setType("scene");
request.setOption("{}");

CreateUploadPolicyResponse response = client.createUploadPolicy(request);
if (response.getBody().success){
      // ...
}

正常返回示例

XML格式

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

<CreateUploadPolicyResponse>
    <RequestId>B28A2ECB-AB29-1E01****</RequestId>
    <Code>200</Code>
    <Success>true</Success>
    <Message>SUCCESS</Message>
    <Data>
        <AccessId>LTAI5t9k9****</AccessId>
        <Policy>eyJleHBpcmF0aW9uIjoiMj****</Policy>
        <Signature>KdnPJFIG25SM****</Signature>
        <Dir>dir/</Dir>
        <Host>oss.aliyun.com</Host>
        <Expire>1658812297</Expire>
        <Callback>""</Callback>
    </Data>
</CreateUploadPolicyResponse>

JSON格式

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

{
  "RequestId" : "B28A2ECB-AB29-1E01****",
  "Code" : 200,
  "Success" : true,
  "Message" : "SUCCESS",
  "Data" : {
    "AccessId" : "LTAI5t9k9****",
    "Policy" : "eyJleHBpcmF0aW9uIjoiMj****",
    "Signature" : "KdnPJFIG25SM****",
    "Dir" : "dir/",
    "Host" : "oss.aliyun.com",
    "Expire" : "1658812297",
    "Callback" : "\"\""
  }
}

错误码

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