Asset Library
FreshManage permanent assets in the GEELark material library.
Upload to Library
Step 1: Get Upload URL
URL: https://openapi.geelark.com/open/v1/material/upload/getUrlMethod: POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| fileType | Yes | string | File extension |
Step 2: Upload via PUT
Same as temporary upload -- use the returned uploadUrl.
Create Material
URL: https://openapi.geelark.com/open/v1/material/addMethod: POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| list | Yes | array | Material items |
| list[].url | Yes | string | Resource URL |
| list[].fileName | No | string | File name |
| list[].tagIds | No | array[string] | Tag IDs |
Delete Material
URL: https://openapi.geelark.com/open/v1/material/deleteMethod: POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| ids | Yes | array[string] | Material IDs |
Set Material Tag
URL: https://openapi.geelark.com/open/v1/material/tag/setMethod: POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| ids | Yes | array[string] | Material IDs |
| tagIds | Yes | array[string] | Tag IDs to set |
Search Material
URL: https://openapi.geelark.com/open/v1/material/listMethod: POST
| Parameter | Required | Type | Description |
|---|---|---|---|
| page | Yes | integer | Page number |
| pageSize | Yes | integer | Items per page |
| tagIds | No | array[string] | Filter by tags |
| ids | No | array[string] | Filter by IDs |
Material Tags
Create Tag
URL: https://openapi.geelark.com/open/v1/material/tag/add
| Parameter | Required | Type | Description |
|---|---|---|---|
| list | Yes | array | Tag items |
| list[].name | Yes | string | Tag name |
Delete Tag
URL: https://openapi.geelark.com/open/v1/material/tag/delete
| Parameter | Required | Type | Description |
|---|---|---|---|
| ids | Yes | array[string] | Tag IDs |
Search Tags
URL: https://openapi.geelark.com/open/v1/material/tag/list
| Parameter | Required | Type | Description |
|---|---|---|---|
| page | Yes | integer | Page number |
| pageSize | Yes | integer | Items per page |
Error Codes
| Code | Description |
|---|---|
| 60001 | Material library capacity exceeded |
| 60002 | Duplicate tag name |
| 60003 | Invalid URL |
| 60004 | File format not supported |
| 60005 | Material does not exist |