Skip to content
RPA
/
/
Gọi mẫu qua HTTP
Last updated

1. Lấy thông tin xác thực (Mã thông báo OAuth2)

Trước khi gọi bất kỳ API chức năng nào, bạn phải đổi thông tin đăng nhập của mình lấy Mã thông báo truy cập JWT.

Yêu cầu (cURL)

curl -i -X POST \
  https://api.morelogin.com/oauth2/token \
  -H 'Content-Type: application/json' \
  -d '{
    "client_id": 1672940217990530,
    "client_secret": "your_client_secret",
    "grant_type": "client_credentials"
  }'

Ví dụ về phản hồi

{
    "code": 0,
    "data": {
        "access_token": "eyJhbGciOiJIUzI1NiIsIn...",
        "token_type": "Bearer",
        "expires_in": 3600
    }
}

2. Thực thi mẫu Cloud Phone

Sử dụng access_token nhận được từ Bước 1 để kích hoạt một mẫu RPA cụ thể.

Yêu cầu (cURL)

curl -i -X POST \
  https://api.morelogin.com/cloudphone/rpa/onceTask/save \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "cloudPhoneId": 16783319661123,
    "scheduleName": "test_automation",
    "templateId": 1678347487160256,
    "templateParameter": "{\"Video Caption\": \"Hello World\", \"AI Label\": true}",
    "description": "schedule description"
  }'

3. Phân tích tham số

Cách lấy ID?

  • Authorization: Lấy được thông qua điểm cuối /oauth2/token.

  • cloudPhoneId: Tìm thấy trong bảng điều khiển Cloud Phone của MoreLogin (ID số).

  • templateId: Tìm thấy trong thị trường Mẫu tự động hóa hoặc danh sách mẫu cá nhân.

Hiểu về templateParameter

Đây là một đối tượng JSON được chuyển đổi thành chuỗi. Bạn phải xác định các khóa dựa trên yêu cầu của mẫu và sau đó mã hóa chúng thành chuỗi.

Ví dụ về định nghĩa mẫu:

**```json { "Video Caption": "string", "AI Label": "boolean", "Product Id": "number", "Get Leads": "boolean", "Comment": "string" }


**Cách ánh xạ nó trong yêu cầu của bạn:**

Để truyền các giá trị cho định nghĩa ở trên, giá trị templateParameter của bạn sẽ có dạng như sau:

```json
{
    "templateParameter": "{\"Video Caption\": \"My Title\", \"AI Label\": true, \"Product Id\": 12345}"
}

4. Xử lý lỗi

| Trạng thái | Lý do có thể |

| ---------------- | ------------------------------------------------------------ |

| 401 Không được phép | Mã thông báo hết hạn hoặc thông tin đăng nhập của máy khách không hợp lệ. |

| 400 Yêu cầu không hợp lệ | cloudPhoneId không hợp lệ hoặc JSON bị lỗi trong templateParameter. |

| 404 Không tìm thấy | templateId không tồn tại. |

Hướng dẫn nhanh Python

import requests
import json

def run_morelogin_task():
    # 1. Auth
    auth_res = requests.post(
        "https://api.morelogin.com/oauth2/token",
        json={
            "client_id": 1672940217990530,
            "client_secret": "your_secret",
            "grant_type": "client_credentials"
        }
    )
    token = auth_res.json()['data']['access_token']

    # 2. Execute
    task_payload = {
        "cloudPhoneId": 16783319661123,
        "templateId": 1678347487160256,
        "templateParameter": json.dumps({
            "Video Caption": "My Post",
            "AI Label": True
        })
    }
    
    headers = {"Authorization": f"Bearer {token}"}
    response = requests.post(
        "https://api.morelogin.com/cloudphone/rpa/onceTask/save",
        json=task_payload,
        headers=headers
    )
    return response.json()

print(run_morelogin_task())

HTTP Request

Make