Upload Files

Fresh

Upload Temporary Files (3-day expiry)

Step 1: Get Upload URL

URL: https://openapi.geelark.com/open/v1/upload/getUrlMethod: POST

Parameter	Required	Type	Description
fileType	Yes	string	File extension

Supported types: jpg, jpeg, png, gif, bmp, webp, heif, heic, mp4, webm, xml, apk, xapk

{ "fileType": "mp4" }

Response

{
  "code": 0,
  "data": {
    "uploadUrl": "https://storage.example.com/upload?token=...",
    "resourceUrl": "https://material-prod.geelark.cn/open-upload/..."
  }
}

Field	Description
uploadUrl	URL to upload file (valid 30 min)
resourceUrl	URL to access the file after upload

Step 2: Upload the File

Use PUT request to upload the file to uploadUrl:

curl -X PUT --upload-file ./video.mp4 "uploadUrl"

After upload, the file is accessible via resourceUrl.

---

Upload Files to Cloud Phone

URL: https://openapi.geelark.com/open/v1/phone/file/uploadMethod: POST

Parameter	Required	Type	Description
id	Yes	string	Cloud phone ID
fileUrl	Yes	string	File URL to download
savePath	Yes	string	Save path on cloud phone

Query Upload Status

URL: https://openapi.geelark.com/open/v1/phone/file/upload/status

Parameter	Required	Type	Description
taskId	Yes	string	Upload task ID

---

Upload Keybox File

URL: https://openapi.geelark.com/open/v1/phone/keybox/uploadMethod: POST

Parameter	Required	Type	Description
id	Yes	string	Cloud phone ID
fileUrl	Yes	string	Keybox file URL

Query Keybox Upload Status

URL: https://openapi.geelark.com/open/v1/phone/keybox/upload/status

Parameter	Required	Type	Description
taskId	Yes	string	Task ID