{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Cloud Phone File Upload and Download"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cloud-phone-file-upload-and-download","__idx":0},"children":["Cloud Phone File Upload and Download"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide shows the complete file-transfer workflow: upload a local file to a Cloud Phone, export a file from the Cloud Phone, poll asynchronous tasks, and recover safely from timeouts."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"choose-an-api-surface","__idx":1},"children":["Choose an API surface"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Step"},"children":["Step"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Open API"},"children":["Open API"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Local API"},"children":["Local API"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.morelogin.com"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["http://127.0.0.1:40000"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Local API token when enabled"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request upload URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudphone/uploadUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudphone/upload/file/signedUrl"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Register uploaded object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudphone/uploadFile"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudphone/upload/file"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query upload result"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudphone/uploadFileResult"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudphone/upload/file/result"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Request file export"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudphone/download"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudphone/download"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query export result"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /cloudphone/download/result"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudphone/download/result"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The examples below use Open API. To use Local API, change the base URL and paths according to the table. Keep Cloud Phone IDs and task IDs as strings; JavaScript clients must not convert them through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Number"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"local-api-multipart-shortcut","__idx":2},"children":["Local API multipart shortcut"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the file is on the same machine as the MoreLogin client, Local API also provides ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/cloudphone/uploadFile"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["multipart/form-data"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \"http://127.0.0.1:40000/api/cloudphone/uploadFile\" \\\n --form 'id=1661515884160372' \\\n --form 'uploadDest=/Download' \\\n --form 'file=@./report.csv'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the signed-URL workflow below when the caller runs remotely, when the file is large, or when you need a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]}," for explicit status polling."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"upload-workflow","__idx":3},"children":["Upload workflow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n participant Client\n participant API as MoreLogin API\n participant Storage as Temporary storage\n participant Phone as Cloud Phone\n Client->>API: 1. Request pre-signed URL\n API-->>Client: presignedUrl\n Client->>Storage: 2. PUT file bytes\n Storage-->>Client: 2xx\n Client->>API: 3. Register object URL\n API-->>Client: fileId, status=0\n loop Until terminal status\n Client->>API: 4. Query upload result\n API-->>Client: null / status 0, 1, or 2\n end\n API->>Phone: Deliver file\n","diagramHtml":"Cloud PhoneTemporary storageMoreLogin APIClientCloud PhoneTemporary storageMoreLogin APIClientloop[Until terminal status]1. Request pre-signed URLpresignedUrl2. PUT file bytes2xx3. Register object URLfileId, status=04. Query upload resultnull / status 0, 1, or 2Deliver file","diagramHtmlDark":"Cloud PhoneTemporary storageMoreLogin APIClientCloud PhoneTemporary storageMoreLogin APIClientloop[Until terminal status]1. Request pre-signed URLpresignedUrl2. PUT file bytes2xx3. Register object URLfileId, status=04. Query upload resultnull / status 0, 1, or 2Deliver file"},"children":["sequenceDiagram\n participant Client\n participant API as MoreLogin API\n participant Storage as Temporary storage\n participant Phone as Cloud Phone\n Client->>API: 1. Request pre-signed URL\n API-->>Client: presignedUrl\n Client->>Storage: 2. PUT file bytes\n Storage-->>Client: 2xx\n Client->>API: 3. Register object URL\n API-->>Client: fileId, status=0\n loop Until terminal status\n Client->>API: 4. Query upload result\n API-->>Client: null / status 0, 1, or 2\n end\n API->>Phone: Deliver file\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-request-a-pre-signed-url","__idx":4},"children":["1. Request a pre-signed URL"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \"https://api.morelogin.com/cloudphone/uploadUrl\" \\\n --header \"Authorization: Bearer $MORELOGIN_TOKEN\" \\\n --header \"Content-Type: application/json\" \\\n --data '{\n \"id\": \"1661515884160372\",\n \"fileName\": \"report.csv\"\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response contains ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.presignedUrl"]},". The temporary object is automatically deleted after 7 days; this does not delete a file that has already been delivered to the Cloud Phone."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-upload-the-file-bytes","__idx":5},"children":["2. Upload the file bytes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send the file directly to the returned URL. Do not add the MoreLogin Bearer token to this storage request."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location --request PUT \\\n --upload-file \"./report.csv\" \\\n \"$PRESIGNED_URL\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only continue after the storage service returns a successful HTTP status. If this request fails or times out, retry the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]}," to the same URL while it remains valid."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-register-the-object-for-delivery","__idx":6},"children":["3. Register the object for delivery"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the uploaded object URL. The query string on a pre-signed URL contains credentials, so remove it before storing or logging the URL when your object-store configuration permits it."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"FILE_URL=\"${PRESIGNED_URL%%\\?*}\"\n\ncurl --request POST \"https://api.morelogin.com/cloudphone/uploadFile\" \\\n --header \"Authorization: Bearer $MORELOGIN_TOKEN\" \\\n --header \"Content-Type: application/json\" \\\n --data \"$(jq -n \\\n --arg id '1661515884160372' \\\n --arg url \"$FILE_URL\" \\\n --arg dest '/Download' \\\n '{id: $id, url: $url, uploadDest: $dest, uploadType: 1}')\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadType: 1"]}," for regular files. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadType: 2"]}," only for supported MP4 live-streaming files. Save ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.fileId"]}," from the response."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-poll-the-upload-result","__idx":7},"children":["4. Poll the upload result"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \"https://api.morelogin.com/cloudphone/uploadFileResult\" \\\n --header \"Authorization: Bearer $MORELOGIN_TOKEN\" \\\n --header \"Content-Type: application/json\" \\\n --data '{\n \"id\": \"1661515884160372\",\n \"fileId\": \"1661515884160111\"\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"data / data.status"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.status"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The task is not visible yet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait and poll again"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Uploading"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait and poll again"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Successful"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stop polling"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Failed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stop polling and report ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestId"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Poll every 2 seconds and set a client-side deadline appropriate for the file size. Do not create another upload task merely because a status request timed out; query the existing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]}," first."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"download-workflow","__idx":8},"children":["Download workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["“Download” is an export from the Cloud Phone to a temporary URL. It is a two-stage asynchronous workflow."]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","diagramType":"mermaid","diagramSource":"sequenceDiagram\n participant Client\n participant API as MoreLogin API\n participant Phone as Cloud Phone\n participant Storage as Temporary storage\n Client->>API: 1. Request file export (id, filePath)\n API->>Phone: Read and export file\n API-->>Client: downId\n loop While status=10\n Client->>API: 2. Query export result (id, downId)\n API-->>Client: status=10\n end\n Phone->>Storage: Write exported file\n API-->>Client: status=20, downUrl\n Client->>Storage: 3. GET downUrl\n Storage-->>Client: File bytes\n","diagramHtml":"Temporary storageCloud PhoneMoreLogin APIClientTemporary storageCloud PhoneMoreLogin APIClientloop[While status=10]1. Request file export (id, filePath)Read and export filedownId2. Query export result (id, downId)status=10Write exported filestatus=20, downUrl3. GET downUrlFile bytes","diagramHtmlDark":"Temporary storageCloud PhoneMoreLogin APIClientTemporary storageCloud PhoneMoreLogin APIClientloop[While status=10]1. Request file export (id, filePath)Read and export filedownId2. Query export result (id, downId)status=10Write exported filestatus=20, downUrl3. GET downUrlFile bytes"},"children":["sequenceDiagram\n participant Client\n participant API as MoreLogin API\n participant Phone as Cloud Phone\n participant Storage as Temporary storage\n Client->>API: 1. Request file export (id, filePath)\n API->>Phone: Read and export file\n API-->>Client: downId\n loop While status=10\n Client->>API: 2. Query export result (id, downId)\n API-->>Client: status=10\n end\n Phone->>Storage: Write exported file\n API-->>Client: status=20, downUrl\n Client->>Storage: 3. GET downUrl\n Storage-->>Client: File bytes\n"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If polling returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30"]}," (failed) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["40"]}," (cancelled), stop the flow and do not request ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["downUrl"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-request-a-file-export","__idx":9},"children":["1. Request a file export"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the absolute Android file path, including the file name."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \"https://api.morelogin.com/cloudphone/download\" \\\n --header \"Authorization: Bearer $MORELOGIN_TOKEN\" \\\n --header \"Content-Type: application/json\" \\\n --data '{\n \"id\": \"1661515884160372\",\n \"filePath\": \"/sdcard/Download/report.csv\"\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Save ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.downId"]},". The request only creates the export task; it does not return the file bytes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-poll-until-the-url-is-ready","__idx":10},"children":["2. Poll until the URL is ready"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \"https://api.morelogin.com/cloudphone/download/result\" \\\n --header \"Authorization: Bearer $MORELOGIN_TOKEN\" \\\n --header \"Content-Type: application/json\" \\\n --data '{\n \"id\": \"1661515884160372\",\n \"downId\": \"1661515884160999\"\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"data.status"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.status"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Running"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wait and poll again"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Successful"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Download from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data.downUrl"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Failed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stop and report ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["40"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancelled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stop; create a new task only if still needed"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20"]},", download the file promptly:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location \"$DOWN_URL\" --output \"./report.csv\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not send the MoreLogin Bearer token to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["downUrl"]},". Treat both pre-signed upload URLs and download URLs as secrets, and never persist them in application logs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"complete-python-example","__idx":11},"children":["Complete Python example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests"]},". It checks both HTTP status and the MoreLogin business ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]},", polls with a deadline, and reuses the returned task IDs."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import os\nimport time\nfrom pathlib import Path\n\nimport requests\n\nBASE_URL = \"https://api.morelogin.com\"\nTOKEN = os.environ[\"MORELOGIN_TOKEN\"]\nPHONE_ID = \"1661515884160372\"\nHEADERS = {\"Authorization\": f\"Bearer {TOKEN}\"}\n\n\ndef api_post(path, payload):\n response = requests.post(\n f\"{BASE_URL}{path}\", json=payload, headers=HEADERS, timeout=30\n )\n response.raise_for_status()\n body = response.json()\n if body.get(\"code\") != 0:\n raise RuntimeError(\n f\"API error code={body.get('code')} msg={body.get('msg')} \"\n f\"requestId={body.get('requestId')}\"\n )\n return body\n\n\ndef wait_for(path, payload, terminal, timeout=300):\n deadline = time.monotonic() + timeout\n while time.monotonic() < deadline:\n body = api_post(path, payload)\n data = body.get(\"data\")\n if data is not None and data.get(\"status\") in terminal:\n return body\n time.sleep(2)\n raise TimeoutError(f\"Timed out while polling {path}; keep the task ID\")\n\n\ndef upload_to_phone(local_path, destination=\"/Download\"):\n path = Path(local_path)\n signed = api_post(\n \"/cloudphone/uploadUrl\", {\"id\": PHONE_ID, \"fileName\": path.name}\n )\n presigned_url = signed[\"data\"][\"presignedUrl\"]\n with path.open(\"rb\") as stream:\n put_response = requests.put(presigned_url, data=stream, timeout=120)\n put_response.raise_for_status()\n\n object_url = presigned_url.split(\"?\", 1)[0]\n created = api_post(\n \"/cloudphone/uploadFile\",\n {\n \"id\": PHONE_ID,\n \"url\": object_url,\n \"uploadDest\": destination,\n \"uploadType\": 1,\n },\n )\n file_id = created[\"data\"][\"fileId\"]\n result = wait_for(\n \"/cloudphone/uploadFileResult\",\n {\"id\": PHONE_ID, \"fileId\": file_id},\n terminal={1, 2},\n )\n if result[\"data\"][\"status\"] != 1:\n raise RuntimeError(f\"Upload failed; requestId={result.get('requestId')}\")\n return file_id\n\n\ndef download_from_phone(remote_path, local_path):\n created = api_post(\n \"/cloudphone/download\", {\"id\": PHONE_ID, \"filePath\": remote_path}\n )\n down_id = created[\"data\"][\"downId\"]\n result = wait_for(\n \"/cloudphone/download/result\",\n {\"id\": PHONE_ID, \"downId\": down_id},\n terminal={20, 30, 40},\n )\n if result[\"data\"][\"status\"] != 20:\n raise RuntimeError(f\"Download export failed; requestId={result.get('requestId')}\")\n\n with requests.get(result[\"data\"][\"downUrl\"], stream=True, timeout=120) as response:\n response.raise_for_status()\n with open(local_path, \"wb\") as output:\n for chunk in response.iter_content(1024 * 1024):\n if chunk:\n output.write(chunk)\n return down_id\n\n\nupload_to_phone(\"./report.csv\")\ndownload_from_phone(\"/sdcard/Download/report.csv\", \"./downloaded-report.csv\")\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"production-checklist","__idx":12},"children":["Production checklist"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code == 0"]},"; HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," alone does not mean the business operation succeeded."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fileId"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["downId"]}," as strings."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retry status queries with backoff. Before repeating a task-creation request after a timeout, query the task ID when one was received."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Limit concurrent transfers and follow the documented ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/getting-started/rate-limits"},"children":["rate limits"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate the local file size and available Cloud Phone storage before large transfers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Record ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestId"]},", endpoint, Cloud Phone ID, task ID, and terminal status for support, but redact tokens and signed URLs."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For field-level schemas, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/cloud-phone/open-api"},"children":["Cloud Phone Open API"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/cloud-phone/local-api"},"children":["Cloud Phone Local API"]},". For general polling and retry rules, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api-reference/getting-started/async-operations"},"children":["Asynchronous Operations"]},"."]}]},"headings":[{"value":"Cloud Phone File Upload and Download","id":"cloud-phone-file-upload-and-download","depth":1},{"value":"Choose an API surface","id":"choose-an-api-surface","depth":2},{"value":"Local API multipart shortcut","id":"local-api-multipart-shortcut","depth":3},{"value":"Upload workflow","id":"upload-workflow","depth":2},{"value":"1. Request a pre-signed URL","id":"1-request-a-pre-signed-url","depth":3},{"value":"2. Upload the file bytes","id":"2-upload-the-file-bytes","depth":3},{"value":"3. Register the object for delivery","id":"3-register-the-object-for-delivery","depth":3},{"value":"4. Poll the upload result","id":"4-poll-the-upload-result","depth":3},{"value":"Download workflow","id":"download-workflow","depth":2},{"value":"1. Request a file export","id":"1-request-a-file-export","depth":3},{"value":"2. Poll until the URL is ready","id":"2-poll-until-the-url-is-ready","depth":3},{"value":"Complete Python example","id":"complete-python-example","depth":2},{"value":"Production checklist","id":"production-checklist","depth":2}],"frontmatter":{"seo":{"title":"Cloud Phone File Upload and Download"}},"lastModified":"2026-09-02T11:22:17.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-reference/cloud-phone/file-transfer","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}