Wayline KMZ File Import Callback

POST

/openapi/v2.0/wayline/api/v1/workspaces/{workspace_id}/import-callback

After client directly uploads wayline KMZ file to OSS, calls this API to notify server to register import status. Server parses KMZ metadata (waypoints, actions, payload requirements, etc.), writes to wayline library, and triggers subsequent flows like duplicate-name validation and template type identification.

Request

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "object_key": "uploads/2026/file_001.kmz",
    "name": "example_name",
    "file_type": 5,
    "file_source": 1,
    "parent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/wayline/api/v1/workspaces//import-callback' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Request-Id: 5dff27bd-693c-4ace-979d-e26e920d497a' \
--header 'X-Request-Id;' \
--header 'X-Project-Uuid;' \
--header 'Content-Type: application/json' \
--data '{
    "object_key": "uploads/2026/file_001.kmz",
    "name": "example_name",
    "file_type": 5,
    "file_source": 1,
    "parent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}'

Responses

🟢200

application/json

Returns request_id Immediately

Bodyapplication/json

Example

{
    "code": 0,
    "message": "Ok",
    "data": {
        "key": "org-uuid/wayline/import-kmz-001.kmz",
        "name": "External Imported Wayline.kmz",
        "uuid": "wayline-uuid-imported-001",
        "request_id": "req-uuid-import-001"
    }
}

🟠400

🟠401

Modified at 2026-06-15 13:36:31

Wayline Save KMZ Upload Completion Callback

Batch Download Waylines / Folders (ZIP Package)