Cloud-to-Cloud Integration Documentation

Architectural Design

1. Configure AWS Cloud OSS details and callback address in FlightHub 2.

2. After completing the wayline mission, the dock uploads media files to the corresponding AWS Cloud OSS.

3. Upon receiving successful file upload notification, FlightHub 2 sends callback data to the user's specified cloud platform through the configured callback address.

Integration Process

Operator: Third-party Partners

Process Details

Preparation

Media transmission parameter configuration.

Storage Address

Use STS temporary credentials to access OSS, refer to AWS Cloud's official documentation for configuration information.

{
"access_key_id":"xxxxxxx", // required
"access_key_secret":"xxxxxxxx", // required
"bucket":"xx-bucket", // required
"region":"us-east-1", // required
"arn":"xxxxxx", // required
"policy": "xxxxxxx", // Initial configuration is necessary; subsequent configurations may be optional
"role_session_name":"xxxxx", // required
"provider":"aws" // required, aws or ali
}

API Address (Notification Receiving Interface)

Must be an HTTPS interface, such as https://x.com/xxx

Request Parameters:

{
    "notify_type":"drc_file_upload_complete",
    "org_id":"Organization ID",
    "org_name":"Organization Name",
    "prj_id":"Project ID",
    "prj_name":"Project Name",
    "sn":"Device SN",
    "task_info":{
        "task_type":"Task Type",
        "tags":["Tag 1","Tag 2"]
    },
    "files":[
        {
            "name":"Name",
            "key":"AWS Cloud key"
        }
    ],
    "folder_info":{
        "expected_file_count":0,
        "uploaded_file_count":0,
        "folder_id":0
    }
}

Return:

{
    "code":0,
    "message":"Error Message when code is not 0"
}

Configuration

1. Access organization settings with admin rights.

2. Configure storage bucket details.

3. Refer to the preparation section, formatted as JSON.

4. Enable the Media File Direct Transfer function

5. Schedule tasks for Media File Direct Transfer and set tags.

Testing

1. After flight, check if the media file library transmission is completed, and there should be a popup notification says "media uploaded to third party platform + task tag".

    2. Confirm third-party platforms receive notifications on time with right format and complete information (organization + project + device + task + file + tag).

{
    "notify_type":"drc_file_upload_complete",
    "org_id":"Organization ID",
    "org_name":"Organization Name",
    "prj_id":"Project ID",
    "prj_name":"Project Name",
    "sn":"Device SN",
    "task_info":{
        "task_type":"Task Type",
        "tags":["Tag 1","Tag 2"]
    },
    "files":[
        {
            "name":"Name",
            "key":"AWS Cloud key"
        }
    ],
    "folder_info":{
        "expected_file_count":0,
        "uploaded_file_count":0,
        "folder_id":0
    }
}

FAQ

1. What happens if the STS credentials are incorrect in FlightHub 2?FlightHub 2 will display an error when saving STS. Successful setup means correct STS.

2. If the client platform doesn't process FlightHub 2 callbacks, will there be retries?Yes, in the first 2 hours, there's a callback every 30 minutes. Afterwards, it's every 2 hours.

3. Supported oss

   AWS, Ali