get_upload_record_v1
Check the status of a V1 map upload for GS cleaning robots by providing the upload record ID to monitor progress and retrieve upload information.
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 registration and handler for 'get_upload_record_v1'. This is the entrypoint exposed via MCP, decorated with @mcp.tool() and delegates execution to the GausiumMCP 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)
- Core helper method in GausiumMCP class that implements the logic: validates record_id and calls the Gausium API endpoint to retrieve the upload record 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 (registration)API endpoint registration/definition for the underlying Gausium OpenAPI call used by the MCP tool handler.'get_upload_record_v1': APIEndpoint( name="get_upload_record_v1", path="map/upload/{record_id}", method=HTTPMethod.GET, version=APIVersion.OPENAPI_V1, description="V1地图上传状态检查" ),