Join Project via Quick Join Code

POST

/openapi/v2.0/manage/api/v1/projects/fast-join

Use project quick join code to add current user to specified project. If user is not in project's organization, automatically joins organization as temporary member. Optionally associate an aircraft to project at the same time.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "project_fast_join": {
        "project_id": "PRJ-001",
        "project_fast_join_code": "ABC123",
        "user_project_callsign": "Pilot Xiao Wang"
    },
    "association_drone": {
        "drone_device_sn": "1581F5FKD232800D378V",
        "drone_project_callsign": "M350 RTK-001",
        "drone_model_key": "0-67-0"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v2.0/manage/api/v1/projects/fast-join' \
--header 'x-user-token;' \
--header 'x-user-token;' \
--header 'X-Project-Uuid;' \
--header 'X-Request-Id;' \
--header 'X-Request-Id;' \
--header 'Content-Type: application/json' \
--data '{
    "project_fast_join": {
        "project_id": "PRJ-001",
        "project_fast_join_code": "ABC123",
        "user_project_callsign": "Pilot Xiao Wang"
    },
    "association_drone": {
        "drone_device_sn": "1581F5FKD232800D378V",
        "drone_project_callsign": "M350 RTK-001",
        "drone_model_key": "0-67-0"
    }
}'

Responses

🟢200

application/json

Success

Bodyapplication/json

Example

{
    "code": 0,
    "message": "OK",
    "data": {
        "project_uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "project_id": "PRJ-001",
        "project_name": "Inspection Project A",
        "organization_name": "Test Organization",
        "organization_uuid": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    }
}

🟠400

🔴500

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

Query Quick Join Project Info

Query Organization Project List