app reports file upload result

POST

/media/api/v1/workspaces/{workspace_id}/upload-callback

When the file is uploaded to the storage server by pilot,
the basic information of the file is reported through this interface.
app reports file upload result
When the file is uploaded to the storage server by pilot, the basic information of the file is reported through this interface.

请求参数

Path 参数

workspaceId

string

必需

Query 参数

workspace_id

可选

workspace id

Header 参数

x-auth-token

string

可选

默认值:

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ3b3Jrc3BhY2VfaWQiOiJlM2RlYTBmNS0zN2YyLTRkNzktYWU1OC00OTBhZjMyMjgwNjkiLCJzdWIiOiJDbG91ZEFwaVNhbXBsZSIsInVzZXJfdHlwZSI6IjEiLCJuYmYiOjE3NDkwODYzMDEsImxvZyI6IkxvZ2dlcltjb20uZGppLnNhbXBsZS5jb21tb24ubW9kZWwuQ3VzdG9tQ2xhaW1dIiwiaXNzIjoiREpJIiwiaWQiOiJhMTU1OWU3Yy04ZGQ4LTQ3ODAtYjk1Mi0xMDBjYzQ3OTdkYTIiLCJleHAiOjE4MzU0ODYzMDEsImlhdCI6MTc0OTA4NjMwMSwidXNlcm5hbWUiOiJhZG1pblBDIn0.W5x4fh7PWALqknARx8aoGQhK8ci5t6U7mITN1Gbn4H0

Body 参数application/json

object_key

string

必需

The key of the object in the bucket

示例值:

media/DJI_20220831151616_0004_W_Waypoint4.JPG

sub_file_type

enum<string>

必需

枚举值:

NORMALPANORAMA

ext

object (MediaFileExtension)

必需

drone_model_key

enum<string>

必需

drone device product enum

枚举值:

M350M300M30M30TM3EM3TM3MZ30XT2FPVXTSH20H20TP1M30_CAMERAM30T_CAMERAH20NDOCK_CAMERAL1M3E_CAMERAM3T_CAMERAM3M_CAMERARCRC_PLUSRC_PRODOCKDOCK2M3DM3TDM3D_CAMERAM3TD_CAMERA

file_group_id

string

必需

If the media file was shot during the wayline, this value will not be null.

is_original

boolean

必需

Whether the image is the original image.

payload_model_key

enum<string>

必需

payload device product enum

枚举值:

M350M300M30M30TM3EM3TM3MZ30XT2FPVXTSH20H20TP1M30_CAMERAM30T_CAMERAH20NDOCK_CAMERAL1M3E_CAMERAM3T_CAMERAM3M_CAMERARCRC_PLUSRC_PRODOCKDOCK2M3DM3TDM3D_CAMERAM3TD_CAMERA

示例值:

1-42-0

tinny_fingerprint

string

必需

tiny fingerprint of the file.

示例值:

297f490b0252690d3f93841818567cc6_2022_8_31_15_16_16

string

drone sn

必需

示例值:

1AD3CA2VL3LAD6

fingerprint

string

必需

media file fingerprint

示例值:

7F78C9F1999425CB61F10E1FE206009E

name

string

必需

media file name

示例值:

DJI_20220831151616_0004_W_Waypoint4.JPG

path

string

可选

media file path. This value is empty if the photo was not taken in the wayline.

示例值:

DJI_202208311455_008_Waypoint1

metadata

object (MediaFileMetadata)

必需

absolute_altitude

number

必需

absolute height

示例值:

-36.889

created_time

string

必需

media create time

示例值:

2023-01-01T20:00:00+08:00

gimbal_yaw_degree

number

必需

gimbal yaw degree

示例值:

-4.3

shoot_position

object (Position)

必需

The latitude and longitude of the drone when the photo was taken

relative_altitude

number

必需

relative altitude

示例值:

100.001

示例

{
    "object_key": "media/DJI_20220831151616_0004_W_Waypoint4.JPG",
    "sub_file_type": "NORMAL",
    "ext": {
        "drone_model_key": "M350",
        "file_group_id": "string",
        "is_original": true,
        "payload_model_key": "M350",
        "tinny_fingerprint": "297f490b0252690d3f93841818567cc6_2022_8_31_15_16_16",
        "sn": "1AD3CA2VL3LAD6"
    },
    "fingerprint": "7F78C9F1999425CB61F10E1FE206009E",
    "name": "DJI_20220831151616_0004_W_Waypoint4.JPG",
    "path": "DJI_202208311455_008_Waypoint1",
    "metadata": {
        "absolute_altitude": -36.889,
        "created_time": "2023-01-01T20:00:00+08:00",
        "gimbal_yaw_degree": -4.3,
        "shoot_position": {
            "lat": 22.577666,
            "lng": 113.943194
        },
        "relative_altitude": 100.001
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/media/api/v1/workspaces//upload-callback' \
--header 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ3b3Jrc3BhY2VfaWQiOiJlM2RlYTBmNS0zN2YyLTRkNzktYWU1OC00OTBhZjMyMjgwNjkiLCJzdWIiOiJDbG91ZEFwaVNhbXBsZSIsInVzZXJfdHlwZSI6IjEiLCJuYmYiOjE3NDkwODYzMDEsImxvZyI6IkxvZ2dlcltjb20uZGppLnNhbXBsZS5jb21tb24ubW9kZWwuQ3VzdG9tQ2xhaW1dIiwiaXNzIjoiREpJIiwiaWQiOiJhMTU1OWU3Yy04ZGQ4LTQ3ODAtYjk1Mi0xMDBjYzQ3OTdkYTIiLCJleHAiOjE4MzU0ODYzMDEsImlhdCI6MTc0OTA4NjMwMSwidXNlcm5hbWUiOiJhZG1pblBDIn0.W5x4fh7PWALqknARx8aoGQhK8ci5t6U7mITN1Gbn4H0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "object_key": "media/DJI_20220831151616_0004_W_Waypoint4.JPG",
    "sub_file_type": "NORMAL",
    "ext": {
        "drone_model_key": "M350",
        "file_group_id": "string",
        "is_original": true,
        "payload_model_key": "M350",
        "tinny_fingerprint": "297f490b0252690d3f93841818567cc6_2022_8_31_15_16_16",
        "sn": "1AD3CA2VL3LAD6"
    },
    "fingerprint": "7F78C9F1999425CB61F10E1FE206009E",
    "name": "DJI_20220831151616_0004_W_Waypoint4.JPG",
    "path": "DJI_202208311455_008_Waypoint1",
    "metadata": {
        "absolute_altitude": -36.889,
        "created_time": "2023-01-01T20:00:00+08:00",
        "gimbal_yaw_degree": -4.3,
        "shoot_position": {
            "lat": 22.577666,
            "lng": 113.943194
        },
        "relative_altitude": 100.001
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

可选

0 means success, non-zero means error.

示例值:

message

string

可选

The response message.

示例值:

success

data

string

可选

The response data.

示例

{
  "code": 0,
  "message": "",
  "data": ""
}

修改于 2025-06-05 01:52:34

media fast upload

checks whether the file fingerprint exists