创建场景数据回灌-CreateSceneDataReplay

功能介绍

此接口用于创建pblog格式的场景数据回灌信息。接口基于数据回灌文件的sha256判断数据回灌文件是否已存在，如果数据回灌文件不存在，响应中提供预签链接用于上传数据回灌文件。

URI

POST https://{hostURL}/v2/{project_id}/sim/sm/replays

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
file	是	FileCreateSrlz object	数据回灌文件信息。
format	否	string	数据回灌文件格式，当前仅支持pblog格式，默认值为pblog

表3 FileCreateSrlz
参数	是否必选	参数类型	描述
sha256	是	String	数据回灌文件sha256值。
filename	是	String	数据回灌文件名。

响应参数

状态码：201

表4 响应Body参数
参数	参数类型	描述
url	String	数据回灌资源地址。
id	Integer	数据回灌ID。
created_at	Double	创建时间。
updated_at	Double	更新时间。
file	FileCreateSrlz object	数据回灌文件信息。
format	string	数据回灌文件格式，当前仅支持pblog格式。

表5 FileCreateSrlz
参数	参数类型	描述
url	String	文件资源地址。
sha256	String	文件sha256值。
created_at	TimeStamp	创建时间。
updated_at	TimeStamp	更新时间。
post	post object	POST预签链接信息，用于上传文件。
put_url	String	PUT预签链接地址，用于上传文件。优先使用POST方法上传。
get_url	String	GET地址，用于下载文件。
expire	Integer	默认失效时间为600秒。
ready	Boolean	文件状态。完成文件上传状态为true，未完成文件上传状态为false。
filename	String	文件名。

表6 post
参数	参数类型	描述
url	String	POST预签链接信息，用于上传文件。
fields	PostResponseField object	POST预签链接信息，调用POST预签链接上传文件时用于构造请求。

表7 PostResponseField
参数	参数类型	描述
key	String	Post预签链接Key字段，在创建请求时需要添加到请求头。
x-amz-algorithm	String	Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。
x-amz-credential	String	Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。
x-amz-date	String	Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。
policy	String	Post预签链接policy字段，在创建请求时需要添加到请求头。
x-amz-signature	String	Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。

请求示例

创建场景地图

POST https://{endpoint}/v2/{project_id}/sim/sm/replays

{
    "format": "pblog",
    "file": {
        "sha256": "597bcaf23420xxxx9582f1ec8244bd73b3b013c3a14",
        "filename": "PBlog_player.pblog"
    }
}

响应示例

状态码：201

请求成功

{
	"url": "/v2/54d37c8xxxxf4ee9772687bf/sim/sm/replays/123/",
	"id": 123,
	"created_at": 1758185279.99988,
	"updated_at": 1758185279.999914,
	"file": {
		"url": "/v2/54d37c8xxxxf4ee9772687bf/sim/sm/files/597bcaf23420xxxx9582f1ec8244bd73b3b013c3a14/",
		"sha256": "597bcaf23420xxxx9582f1ec8244bd73b3b013c3a14",
		"created_at": 1758185279.995749,
		"updated_at": 1758185279.995806,
		"post": {
			"url": "https://octopus-raw-54d37c8xxxxf4ee9772687bf.obs.xxx.com/",
			"fields": {
				"key": "sim/ifiles/replay/597bcaf23420xxxx9582f1ec8244bd73b3b013c3a14.pblog",
				"x-amz-algorithm": "AWS4-HMAC-SHA256",
				"x-amz-credential": "HPUxxxD/20250918/cn-xxx-x/s3/aws4_request",
				"x-amz-date": "20250918T084800Z",
				"policy": "eyJleHBpcmF0aW9uIjogxxxxxF0ZSI6ICIyMDI1MDkxOFQwODQ4MDBaIn1dfQ==",
				"x-amz-signature": "d972acdxxxxxxxxxx875e1ff0d2fab6504334be62a58ad"
			}
		},
		"put_url": "",
		"get_url": null,
		"expire": 600,
		"ready": false,
		"filename": "PBlog_player.pblog"
	},
	"format": "pblog"
}