{
 "info": {
  "name": "ADSSPEED — API cục bộ (Bản 2.9.220)",
  "description": "27 lệnh API cục bộ của ADSSPEED — Bản 2.9.220. Đặt biến api_key = khoá trong Cài đặt → API & Tích hợp; base_url mặc định http://127.0.0.1:19555. Tài liệu: https://adsspeed.com/adsspeed_api.html",
  "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
 },
 "auth": {
  "type": "apikey",
  "apikey": [
   {
    "key": "key",
    "value": "X-API-Key",
    "type": "string"
   },
   {
    "key": "value",
    "value": "{{api_key}}",
    "type": "string"
   },
   {
    "key": "in",
    "value": "header",
    "type": "string"
   }
  ]
 },
 "variable": [
  {
   "key": "base_url",
   "value": "http://127.0.0.1:19555"
  },
  {
   "key": "api_key",
   "value": "API_KEY"
  }
 ],
 "item": [
  {
   "name": "Điều khiển hồ sơ",
   "item": [
    {
     "name": "Mở hồ sơ",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/browser/start?profile_id=1",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "browser",
        "start"
       ],
       "query": [
        {
         "key": "profile_id",
         "value": "1"
        }
       ]
      },
      "description": "Mở trình duyệt của hồ sơ, trả cổng điều khiển cho Selenium / Puppeteer / Playwright. Đang mở rồi thì trả luôn cổng đang dùng (already_open)."
     }
    },
    {
     "name": "Đóng hồ sơ",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/browser/stop?profile_id=1",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "browser",
        "stop"
       ],
       "query": [
        {
         "key": "profile_id",
         "value": "1"
        }
       ]
      },
      "description": "Đóng trình duyệt của hồ sơ."
     }
    },
    {
     "name": "Hồ sơ có đang mở?",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/browser/active?profile_id=1",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "browser",
        "active"
       ],
       "query": [
        {
         "key": "profile_id",
         "value": "1"
        }
       ]
      },
      "description": "Active / Inactive kèm cổng điều khiển nếu đang mở."
     }
    },
    {
     "name": "Hồ sơ đang mở",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/browser/list",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "browser",
        "list"
       ]
      },
      "description": "Mọi hồ sơ đang mở cùng cổng điều khiển."
     }
    },
    {
     "name": "Xoá cache",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/browser/clear-cache",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "browser",
        "clear-cache"
       ]
      },
      "description": "Xoá bộ nhớ đệm, GIỮ cookie và đăng nhập. Hồ sơ phải đang đóng.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"profile_id\": 2\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    }
   ]
  },
  {
   "name": "Thông tin hồ sơ",
   "item": [
    {
     "name": "Danh sách hồ sơ",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/profile/list?page=1&page_size=50",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "profile",
        "list"
       ],
       "query": [
        {
         "key": "page",
         "value": "1"
        },
        {
         "key": "page_size",
         "value": "50"
        }
       ]
      },
      "description": "Có phân trang."
     }
    },
    {
     "name": "Chi tiết hồ sơ",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/profile/detail?profile_id=1",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "profile",
        "detail"
       ],
       "query": [
        {
         "key": "profile_id",
         "value": "1"
        }
       ]
      },
      "description": "Tên, nhóm, nhãn, ghi chú, proxy (mật khẩu che ***), thư mục dữ liệu."
     }
    },
    {
     "name": "Danh sách nhóm",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/group/list",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "group",
        "list"
       ]
      },
      "description": "Nhóm hồ sơ và số hồ sơ mỗi nhóm."
     }
    }
   ]
  },
  {
   "name": "Thao tác hồ sơ",
   "item": [
    {
     "name": "Tạo hồ sơ",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/profile/create",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "profile",
        "create"
       ]
      },
      "description": "Tạo MỘT hồ sơ. Vân tay do app sinh theo OS / trình duyệt.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"name\": \"Shop VN 01\",\n  \"os\": \"Windows\",\n  \"browser\": \"Chrome\",\n  \"group\": \"Shop VN\",\n  \"tags\": \"shopee, vn\",\n  \"proxy\": \"203.0.113.10:8000:user1:pass1\",\n  \"launch_args\": \"--lang=vi\"\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Sửa hồ sơ",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/profile/update",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "profile",
        "update"
       ]
      },
      "description": "Chỉ đổi trường được gửi.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"profile_id\": 1,\n  \"note\": \"Tài khoản chính\",\n  \"proxy\": {\n    \"type\": \"HTTP\",\n    \"host\": \"203.0.113.30\",\n    \"port\": 8000,\n    \"user\": \"user5\",\n    \"pass\": \"pass5\"\n  }\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Nhân bản hồ sơ",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/profile/duplicate",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "profile",
        "duplicate"
       ]
      },
      "description": "Tạo bản sao với thư mục dữ liệu riêng.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"profile_id\": 2\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Xoá hồ sơ",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/profile/delete",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "profile",
        "delete"
       ]
      },
      "description": "Đưa vào Thùng rác (khôi phục được trong app).",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"profile_ids\": [\n    4\n  ]\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Chuyển nhóm",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/group/assign",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "group",
        "assign"
       ]
      },
      "description": "Đưa các hồ sơ vào một nhóm.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"profile_ids\": [\n    3\n  ],\n  \"group\": \"TikTok\"\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Đổi tên nhóm",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/group/rename",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "group",
        "rename"
       ]
      },
      "description": "Đổi tên nhóm",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"old\": \"TikTok\",\n  \"new\": \"TikTok US\"\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Xoá nhóm",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/group/delete",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "group",
        "delete"
       ]
      },
      "description": "Mặc định chỉ bỏ nhóm, giữ nguyên hồ sơ.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"group\": \"Tạm\"\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Cấu hình mẫu",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/config/list",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "config",
        "list"
       ]
      },
      "description": "Các cấu hình mẫu tạo trong app (active = đang bật)."
     }
    },
    {
     "name": "Chi tiết cấu hình mẫu",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/config/detail?config_id=1",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "config",
        "detail"
       ],
       "query": [
        {
         "key": "config_id",
         "value": "1"
        }
       ]
      },
      "description": "Tên, OS, trình duyệt, phiên bản OS của một cấu hình."
     }
    },
    {
     "name": "Bật cấu hình mẫu",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/config/apply",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "config",
        "apply"
       ]
      },
      "description": "Hồ sơ tạo qua API sau đó theo cấu hình này. 0 = tắt.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"config_id\": 1\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    }
   ]
  },
  {
   "name": "Proxy",
   "item": [
    {
     "name": "Kho proxy",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/proxy/list",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "proxy",
        "list"
       ]
      },
      "description": "Proxy trong kho (mật khẩu che)."
     }
    },
    {
     "name": "Nhập proxy vào kho",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/proxy/import",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "proxy",
        "import"
       ]
      },
      "description": "Dòng sai định dạng bị bỏ qua và đếm vào skipped.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"proxies\": [\n    \"203.0.113.21:8000:user3:pass3\",\n    {\n      \"type\": \"SOCKS5\",\n      \"host\": \"203.0.113.22\",\n      \"port\": 1080,\n      \"user\": \"user4\",\n      \"pass\": \"pass4\"\n    }\n  ],\n  \"group\": \"US-Res\"\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Gán proxy kho cho hồ sơ",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/proxy/assign",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "proxy",
        "assign"
       ]
      },
      "description": "1 proxy → mọi hồ sơ; N proxy → chia vòng.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"proxy_ids\": [\n    1\n  ],\n  \"profile_ids\": [\n    3\n  ]\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Nhóm proxy",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/proxy/group/list",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "proxy",
        "group",
        "list"
       ]
      },
      "description": "Nhóm proxy"
     }
    },
    {
     "name": "Proxy trong nhóm",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/proxy/group/detail?name=US-Res",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "proxy",
        "group",
        "detail"
       ],
       "query": [
        {
         "key": "name",
         "value": "US-Res"
        }
       ]
      },
      "description": "Proxy trong nhóm"
     }
    },
    {
     "name": "Đưa proxy vào nhóm",
     "request": {
      "method": "POST",
      "url": {
       "raw": "{{base_url}}/api/v1/proxy/group/assign",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "proxy",
        "group",
        "assign"
       ]
      },
      "description": "Tên rỗng = bỏ khỏi nhóm.",
      "header": [
       {
        "key": "Content-Type",
        "value": "application/json"
       }
      ],
      "body": {
       "mode": "raw",
       "raw": "{\n  \"proxy_ids\": [\n    2\n  ],\n  \"name\": \"US-Res\"\n}",
       "options": {
        "raw": {
         "language": "json"
        }
       }
      }
     }
    },
    {
     "name": "Dcom 4G",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/dcom/list",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "dcom",
        "list"
       ]
      },
      "description": "Thiết bị Dcom và proxy của chúng."
     }
    },
    {
     "name": "Đổi IP Dcom",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/dcom/rotate?name=DCOM-1",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "dcom",
        "rotate"
       ],
       "query": [
        {
         "key": "name",
         "value": "DCOM-1"
        }
       ]
      },
      "description": "Đổi IP Dcom"
     }
    }
   ]
  },
  {
   "name": "Tiện ích",
   "item": [
    {
     "name": "Kho tiện ích",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/api/v1/extension/list",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "api",
        "v1",
        "extension",
        "list"
       ]
      },
      "description": "Kho tiện ích"
     }
    }
   ]
  },
  {
   "name": "Hệ thống",
   "item": [
    {
     "name": "API có đang chạy?",
     "request": {
      "method": "GET",
      "url": {
       "raw": "{{base_url}}/status",
       "host": [
        "{{base_url}}"
       ],
       "path": [
        "status"
       ]
      },
      "description": "Không cần khoá. Trả phiên bản app.",
      "auth": {
       "type": "noauth"
      }
     }
    }
   ]
  }
 ]
}