小文件上傳編碼 | AppForges Developer Center

公開合同

POST /v1/creative/assets 接收JSON，二進制字段 data 是base64字符串；它不是multipart。實際調用需要端點允許的用戶/組織身份、creative:write及適用項目參數，詳見API Reference。編碼helper不執行網絡請求，也不負責創建項目。

helper只接受嚴格小於 4 MiB 的內存字節；達到或超過邊界會拒絕。空字節、NUL及非UTF8數據都按二進制編碼。以下示例輸出 AP8=，安裝見快速開始。

TypeScript

import { encodeUploadData } from "@appforges/sdk/runtime/upload";
console.log(encodeUploadData(new Uint8Array([0, 255])));

Python

from appforges import encode_upload_data
print(encode_upload_data(bytes([0, 255])))

Go

package main
 
import (
    "fmt"
    "log"
    "github.com/appforges/appforges-sdk-go/runtime"
)
 
func main() {
    data, err := runtime.EncodeUploadData([]byte{0, 255})
    if err != nil { log.Fatal(err) }
    fmt.Println(data)
}

放入JSON請求

編碼結果放入生成的UploadAsset請求 data 字段，其他字段按API Reference填寫。JSON下面只展示編碼字段：

{"data": "AP8="}

當前公開REST沒有大文件預簽名上傳/確認接口。不要將資產訪問URL的重籤當成上傳URL。大文件接入需另行確認可用服務合同；不把本例直接套到4MiB以上文件。

寫請求的重試和 X-Idempotency-Key 見錯誤與重試。