Руководство описывает полный процесс: загрузку локального файла, экспорт файла из Cloud Phone, опрос асинхронных задач и восстановление после тайм-аутов.
| Шаг | Open API | Local API |
|---|---|---|
| Base URL | https://api.morelogin.com | http://127.0.0.1:40000 |
| Аутентификация | Authorization: Bearer <token> | Local API token |
| Запросить URL загрузки | POST /cloudphone/uploadUrl | POST /api/cloudphone/upload/file/signedUrl |
| Зарегистрировать объект | POST /cloudphone/uploadFile | POST /api/cloudphone/upload/file |
| Проверить результат загрузки | POST /cloudphone/uploadFileResult | POST /api/cloudphone/upload/file/result |
| Запросить экспорт | POST /cloudphone/download | POST /api/cloudphone/download |
| Проверить результат экспорта | POST /cloudphone/download/result | POST /api/cloudphone/download/result |
Примеры используют Open API. Для Local API замените базовый URL и пути по таблице. Храните id, fileId и downId как строки; JavaScript не должен преобразовывать их через Number.
Если файл находится на компьютере с клиентом MoreLogin, его можно отправить напрямую. Успешный ответ — пустой объект без ID задачи. Для наблюдаемого статуса и повторов используйте подписанный URL.
curl --request POST "http://127.0.0.1:40000/api/cloudphone/uploadFile" \
--form 'id=1661515884160372' \
--form 'uploadDest=/Download' \
--form 'file=@./report.csv'curl --request POST "https://api.morelogin.com/cloudphone/uploadUrl" \
--header "Authorization: Bearer $MORELOGIN_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"id": "1661515884160372",
"fileName": "report.csv"
}'curl --location --request PUT \
--upload-file "./report.csv" \
"$PRESIGNED_URL"FILE_URL="${PRESIGNED_URL%%\?*}"
curl --request POST "https://api.morelogin.com/cloudphone/uploadFile" \
--header "Authorization: Bearer $MORELOGIN_TOKEN" \
--header "Content-Type: application/json" \
--data "$(jq -n \
--arg id '1661515884160372' \
--arg url "$FILE_URL" \
--arg dest '/Download' \
'{id: $id, url: $url, uploadDest: $dest, uploadType: 1}')"curl --request POST "https://api.morelogin.com/cloudphone/uploadFileResult" \
--header "Authorization: Bearer $MORELOGIN_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"id": "1661515884160372",
"fileId": "1661515884160111"
}'Сохраните data.presignedUrl. Передайте файл напрямую по этому URL без Bearer-токена. Продолжайте только после успешного HTTP-статуса, зарегистрируйте URL объекта и сохраните data.fileId.
data / data.status | Значение | Действие |
|---|---|---|
null | Задача пока не видна | Подождать и повторить |
0 | Загрузка | Подождать и повторить |
1 | Успешно | Прекратить опрос |
2 | Ошибка | Остановиться и сообщить requestId |
Скачивание экспортирует файл из Cloud Phone во временный URL. Сохраните data.downId и опрашивайте результат до конечного состояния.
curl --request POST "https://api.morelogin.com/cloudphone/download" \
--header "Authorization: Bearer $MORELOGIN_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"id": "1661515884160372",
"filePath": "/sdcard/Download/report.csv"
}'curl --request POST "https://api.morelogin.com/cloudphone/download/result" \
--header "Authorization: Bearer $MORELOGIN_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"id": "1661515884160372",
"downId": "1661515884160999"
}'data.status | Значение | Действие |
|---|---|---|
10 | Выполняется | Подождать и повторить |
20 | Успешно | Скачать из data.downUrl |
30 | Ошибка | Остановиться и сообщить requestId |
40 | Отменено | Остановиться; новую задачу создавать только при необходимости |
curl --location "$DOWN_URL" --output "./report.csv"Пример проверяет HTTP и бизнес-code, повторно использует ID задач и задаёт срок опроса.
import os
import time
from pathlib import Path
import requests
BASE_URL = "https://api.morelogin.com"
TOKEN = os.environ["MORELOGIN_TOKEN"]
PHONE_ID = "1661515884160372"
HEADERS = {"Authorization": f"Bearer {TOKEN}"}
def api_post(path, payload):
response = requests.post(
f"{BASE_URL}{path}", json=payload, headers=HEADERS, timeout=30
)
response.raise_for_status()
body = response.json()
if body.get("code") != 0:
raise RuntimeError(
f"API error code={body.get('code')} msg={body.get('msg')} "
f"requestId={body.get('requestId')}"
)
return body
def wait_for(path, payload, terminal, timeout=300):
deadline = time.monotonic() + timeout
while time.monotonic() < deadline:
body = api_post(path, payload)
data = body.get("data")
if data is not None and data.get("status") in terminal:
return body
time.sleep(2)
raise TimeoutError(f"Timed out while polling {path}; keep the task ID")
def upload_to_phone(local_path, destination="/Download"):
path = Path(local_path)
signed = api_post(
"/cloudphone/uploadUrl", {"id": PHONE_ID, "fileName": path.name}
)
presigned_url = signed["data"]["presignedUrl"]
with path.open("rb") as stream:
put_response = requests.put(presigned_url, data=stream, timeout=120)
put_response.raise_for_status()
object_url = presigned_url.split("?", 1)[0]
created = api_post(
"/cloudphone/uploadFile",
{
"id": PHONE_ID,
"url": object_url,
"uploadDest": destination,
"uploadType": 1,
},
)
file_id = created["data"]["fileId"]
result = wait_for(
"/cloudphone/uploadFileResult",
{"id": PHONE_ID, "fileId": file_id},
terminal={1, 2},
)
if result["data"]["status"] != 1:
raise RuntimeError(f"Upload failed; requestId={result.get('requestId')}")
return file_id
def download_from_phone(remote_path, local_path):
created = api_post(
"/cloudphone/download", {"id": PHONE_ID, "filePath": remote_path}
)
down_id = created["data"]["downId"]
result = wait_for(
"/cloudphone/download/result",
{"id": PHONE_ID, "downId": down_id},
terminal={20, 30, 40},
)
if result["data"]["status"] != 20:
raise RuntimeError(f"Download export failed; requestId={result.get('requestId')}")
with requests.get(result["data"]["downUrl"], stream=True, timeout=120) as response:
response.raise_for_status()
with open(local_path, "wb") as output:
for chunk in response.iter_content(1024 * 1024):
if chunk:
output.write(chunk)
return down_id
upload_to_phone("./report.csv")
download_from_phone("/sdcard/Download/report.csv", "./downloaded-report.csv")- Проверяйте code == 0: одного HTTP 200 недостаточно.
- Храните ID строками и проверяйте состояние перед повтором записи после тайм-аута.
- Не записывайте токены и подписанные URL; сохраняйте requestId для поддержки.
- Ограничивайте параллельные передачи и соблюдайте лимиты запросов.