资源：创建资源

路由 URL

POST https://playcanvas.com/api/assets

说明

创建新资源。

备注

此接口目前仅支持创建 script、html、css、text、shader 和 json 类型资源。

创建资源接口要求使用 multipart/form-data 发送数据，与其他 REST API 接口不同。

示例

curl -H "Authorization: Bearer {accessToken}" -X POST -F 'name={name}' -F 'projectId={projectId}' -F 'parent={parent}' -F 'preload={preload}' -F 'pow2={pow2}' -F 'file=@./script.js' "https://playcanvas.com/api/assets"

HTTP 请求

POST https://playcanvas.com/api/assets
Authorization: Bearer {accessToken}
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryTdsfsfT

------WebKitFormBoundaryTdsfsfT
Content-Disposition: form-data; name="projectId"

{projectId}
------WebKitFormBoundaryTdsfsfT
Content-Disposition: form-data; name="branchId"

{branchId}
------WebKitFormBoundaryTdsfsfT
Content-Disposition: form-data; name="parent"

{parent}
------WebKitFormBoundaryTdsfsfT
Content-Disposition: form-data; name="preload"

{preload}
------WebKitFormBoundaryTdsfsfT
Content-Disposition: form-data; name=""; filename="script.js"
Content-Type: application/javascript

{fileContent}
------WebKitFormBoundaryTdsfsfT--

参数

名称	类型	必需	说明
name	string	✔️	资源名称。
projectId	number	✔️	项目 ID。
branchId	string	✔️	分支 ID。
parent	number		父资源 ID。
preload	boolean		是否预加载资源（true / false）。
file	file		保存为资源文件的数据。
pow2	boolean		仅用于纹理，默认为 false。是否将纹理调整为二次幂尺寸（true / false）。

响应结构

Status: 201

{
    "id": int,
    "modifiedAt": date,
    "createdAt": date,
    "state": "ready" | "processing" | "error",
    "name": string,
    "type": string,
    "scope":{
        "type": string,
        "id": int
    },
    "source": bool,
    "sourceId": bool,
    "tags": list of strings,
    "preload": bool,
    "data": {
        ... asset data
    },
    "file": {
        "hash": string,
        "filename": string,
        "size": int,
        "url": string
    },
    "parent": int
}

错误

状态码	说明
401	未通过身份验证
403	禁止访问
404	未找到项目
429	请求过多

请求限流

此路由采用资源限流。