get_upload_record_v1

Check the status of a V1 map upload to GS cleaning robots using the upload record ID. Returns current upload status information for monitoring progress.

Instructions

Checks the status of a V1 map upload.

Args:
    record_id: The upload record ID.

Returns:
    A dictionary containing the upload status information.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`record_id`	Yes

Implementation Reference

src/gs_openapi/main.py:187-196 (handler)

MCP tool handler function decorated with @mcp.tool(), which delegates to the underlying mcp instance method.

async def get_upload_record_v1(record_id: str):
    """Checks the status of a V1 map upload.

    Args:
        record_id: The upload record ID.

    Returns:
        A dictionary containing the upload status information.
    """
    return await mcp.get_upload_record_v1(record_id=record_id)

src/gs_openapi/mcp/gausium_mcp.py:513-536 (handler)

Core implementation of get_upload_record_v1 in GausiumMCP class, performs the actual API call to check upload status.

async def get_upload_record_v1(self, record_id: str) -> Dict[str, Any]:
    """
    V1地图上传状态检查。

    Args:
        record_id: 上传记录ID

    Returns:
        上传状态信息

    Raises:
        ValueError: record_id为空
        httpx.HTTPStatusError: API调用错误
        httpx.RequestError: 网络问题
    """
    if not record_id:
        raise ValueError("Record ID cannot be empty")

    async with GausiumAPIClient() as client:
        return await client.call_endpoint(
            'get_upload_record_v1',
            path_params={'record_id': record_id}
        )

src/gs_openapi/core/endpoints.py:190-196 (schema)

API endpoint schema/definition for get_upload_record_v1 used by the GausiumAPIClient.

'get_upload_record_v1': APIEndpoint(
    name="get_upload_record_v1",
    path="map/upload/{record_id}",
    method=HTTPMethod.GET,
    version=APIVersion.OPENAPI_V1,
    description="V1地图上传状态检查"
),

src/gs_openapi/main.py:187-196 (registration)

Registration of the MCP tool via @mcp.tool() decorator.

async def get_upload_record_v1(record_id: str):
    """Checks the status of a V1 map upload.

    Args:
        record_id: The upload record ID.

    Returns:
        A dictionary containing the upload status information.
    """
    return await mcp.get_upload_record_v1(record_id=record_id)

GS Robot MCP Server