TẢI APP PIONLOGIN DESKTOP VỀ ĐỂ SỬ DỤNG API DOCUMENT

Định dạng Request và Response

API của PionLogin sử dụng định dạng JSON cho cả yêu cầu (Request) và phản hồi (Response). Tất cả dữ liệu gửi đi và nhận về đều được mã hóa dưới dạng JSON, đảm bảo tính nhất quán, dễ đọc và dễ xử lý khi tích hợp với script, tool tự động hóa hoặc ứng dụng bên thứ ba.

Mục đích của tài liệu API

Tài liệu API PionLogin được thiết kế dành cho người dùng và lập trình viên, giúp bạn quản lý trình duyệt profile một cách lập trình hóa (programmatically). Thông qua API, bạn có thể thực hiện các thao tác chính sau đây:

• - Tạo mới profile với cấu hình fingerprint, proxy, noise settings, OS, language… tùy chỉnh
• - Cập nhật, chỉnh sửa thông tin profile (tên, proxy, cookie, noise, nhóm…)
• - Xóa profile (thông thường hoặc force-delete)
• - Khởi động (start/open) và đóng (close) profile
• - Tìm kiếm, lấy danh sách profile, nhóm profile, browser engine
• - Kiểm tra trạng thái, lấy chi tiết profile hoặc nhóm

1/ Browser Engines: API for managing browser

GET /api/browsers

Đây là API giúp bạn liệt kê tất cả các phiên bản trình duyệt hiện có trong hệ thống để sử dụng cho các profile.

1.1. Cách test nhanh (trong Swagger UI)

• → Mở Swagger docs của PionLogin.
• → Chọn GET /api/browsers.
• → Nhấn Try it out (không cần điền gì).
• → Nhấn Execute.
• → Kiểm tra response: Nếu success true → danh sách engine xuất hiện trong "data".

2/Profile Groups: API for managing profile groups

GET /api/profile-groups

2.1. Chức năng: Tìm kiếm và liệt kê các nhóm profile (Search profile groups).

2.2. Giải thích các tham số (Parameters)

Khi gọi API này, bạn có thể truyền vào các tham số sau (đều là dạng query string):

• → keyword (string): Từ khóa để tìm kiếm nhóm profile theo tên hoặc thông tin liên quan.
• → pageIndex (integer): Số thứ tự trang muốn lấy. Giá trị mặc định là 1.
• → pageSize (integer): Số lượng bản ghi (nhóm) hiển thị trên mỗi trang. Giá trị mặc định là 10.
• → sortBy (string): Tiêu chí sắp xếp dữ liệu.

Ví dụ: createdAt.desc (Sắp xếp theo thời gian tạo, mới nhất lên đầu).\

2.3. Cách test nhanh (trong Swagger UI)

• →Mở Swagger docs của PionLogin.
• → Chọn GET /api/profile-groups.
• → Nhấn Try it out.
• → Điền các tham số nếu cần (keyword, pageIndex, pageSize, sortBy).
• → Nhấn Execute.
• → Kiểm tra response: success true → danh sách nhóm trong "data".

• 

3/Profiles: API for managing profiles

GET /api/profiles

3.1.1 Chức năng: Tìm kiếm danh sách các profile dựa trên các điều kiện lọc.

3.1.2. Các tham số lọc (Query Parameters)

• → keyword (string): Tìm kiếm profile theo tên hoặc từ khóa liên quan.
• →pageIndex (integer): Số trang (mặc định là 1).
• →pageSize (integer): Số lượng profile trên mỗi trang (mặc định là 10).
• →sortBy (string): Sắp xếp kết quả (Ví dụ: createdAt.desc để hiện profile mới tạo lên đầu).
• →browserStatus (string): Lọc theo trạng thái trình duyệt. Bạn chỉ có thể chọn 1 trong 2 giá trị: OPENING (đang mở) hoặc CLOSED (đã đóng).
• →profileGroupId (string - dạng ID): Lọc các profile thuộc về một nhóm cụ thể nào đó. Bạn có thể lấy ID này từ API Profile Groups trước đó.

3.1.3.Cách thực hiện Test nhanh

• →Nhấn "Try it out".
• →Nếu bạn muốn tìm các profile đang mở, hãy chọn OPENING ở mục browserStatus.
• →Nếu muốn tìm profile trong một nhóm nhất định, dán ID của nhóm đó vào ô profileGroupId.

• →Nhấn "Execute" để xem danh sách trả về.

  

POST /api/profiles

3.2.1. Chức năng: Tạo một profile trình duyệt mới với fingerprint, cấu hình hệ điều hành, ngôn ngữ, user-agent, cookie và các thông số noise randomization riêng biệt. Mỗi profile hoạt động như một môi trường trình duyệt độc lập, giúp quản lý nhiều tài khoản một cách an toàn, tránh bị phát hiện liên kết giữa các tài khoản.

3.2.2.Parameters

• Không có query parameters (No parameters).
• Chỉ sử dụng Request body (bắt buộc, Content-Type: application/json).

3.3.3. Cách test nhanh (trong Swagger UI)

• → Mở Swagger docs của PionLogin.
• →Chọn POST /api/profiles.
• →Nhấn Try it out.
• →Paste body JSON mẫu vào phần Request body.
• →Nhấn Execute.
• →Kiểm tra response: Nếu success true → copy data.id để sử dụng tiếp

• 

GET /api/profiles/{id}

3.3.1. Chức năng: Trả về toàn bộ thông tin chi tiết của một profile đã tạo trước đó. Bạn chỉ cần cung cấp ID profile (lấy từ response của POST /api/profiles hoặc từ GET /api/profiles list).

3.3.2. Parameters (Path Parameter – bắt buộc)

id (string, required, path): ID của profile cần lấy chi tiết.

Không có query parameters khác.

3.3.3. Cách test nhanh (trong Swagger UI)

• → Mở Swagger docs của PionLogin.
• →Chọn GET /api/profiles/{id}.
• →Nhấn Try it out.
• →Dán ID profile
• →Nhấn Execute.
• →Xem response: Nếu success true → profile details đầy đủ trong "data".

• 

POST /api/profiles/{id}

3.4.1. Chức năng: Cập nhật một hoặc nhiều trường của profile hiện có. Các trường bạn gửi trong body sẽ ghi đè lên giá trị cũ; các trường không gửi sẽ giữ nguyên. Endpoint này hỗ trợ partial update (chỉ cập nhật những gì cần).

3.4.2. Parameters (Path Parameter – bắt buộc)

• id (string, required, path): ID của profile cần cập nhật.

3.4.3. Cách test nhanh (trong Swagger UI)

• → Mở Swagger docs của PionLogin.
• → Chọn POST /api/profiles/{id}.
• → Nhấn Try it out.
• → Dán ID profile vào ô id.
• → Paste body JSON (chỉ các trường cần update) vào Request body.
• → Nhấn Execute.
• → Kiểm tra response success true → sau đó dùng GET /api/profiles/{id} để verify thay đổi.

• 

POST /api/profiles/ {id}/delete

3.5.1. Chức năng: Xóa profile theo ID được chỉ định. Sau khi xóa, profile sẽ không còn xuất hiện trong danh sách (GET /api/profiles) và không thể mở lại hoặc cập nhật. Endpoint này thường dùng để quản lý sạch sẽ khi farm acc, loại bỏ profile hỏng hoặc đã hoàn thành nhiệm vụ.

3.5.2. Parameters (Path Parameter – bắt buộc)

• id (string, required, path): ID của profile cần xóa.

3.5.3.Cách test nhanh (trong Swagger UI)

• →Mở Swagger docs của PionLogin.
• →Chọn POST /api/profiles/{id}/delete.
• →Nhấn Try it out.
• →Dán ID profile cần xóa vào ô id.
• →Không cần điền body (nếu Swagger yêu cầu body thì để rỗng {}).
• →Nhấn Execute.
• →Kiểm tra response: Nếu success true → profile đã xóa.

POST /api/profiles/{id}/force-delete

3.6.1. Chức năng: Force-delete profile theo ID được cung cấp.

• Bỏ qua kiểm tra trạng thái (không quan tâm profile đang OPENING hay CLOSED).
• Tự động kill process browser nếu profile đang chạy.
• Xóa vĩnh viễn toàn bộ dữ liệu profile (fingerprint, proxy, cookie, noise settings...).
• Không thể khôi phục sau khi thực hiện.

3.6.2. Parameters (Path Parameter – bắt buộc)

• id (string, required, path): ID của profile cần force-delete.

3.6.3. Cách test nhanh (trong Swagger UI)

• →Mở Swagger docs của PionLogin.
• →Chọn POST /api/profiles/{id}/force-delete.
• →Nhấn Try it out.
• →Điền ID profile vào ô id
• →Không cần body (để rỗng nếu Swagger yêu cầu).
• →Nhấn Execute.
• →Kiểm tra response:
  • →Nếu "success": true → profile đã xóa.
  • →Verify bằng GET /api/profiles hoặc GET /api/profiles/{id} → profile không còn tồn tại.

GET /api/profiles/{id}/start

3.7.1. Chức năng: Mở profile theo ID được chỉ định.

• Nếu profile đang CLOSED → sẽ mở mới cửa sổ trình duyệt.
• Nếu profile đã OPENING → một số phiên bản có thể trả lỗi hoặc bỏ qua (tùy config, khuyến nghị check status trước).
• Hỗ trợ tùy chỉnh vị trí, kích thước cửa sổ khi mở (rất tiện khi chạy multi-profile trên màn hình lớn hoặc nhiều màn hình).

3.7.2. Parameters

• id (string, required, path): ID của profile cần mở.

3.7.3. Cách test nhanh (trong Swagger UI)

• → Mở Swagger docs của PionLogin.
• →Chọn GET /api/profiles/{id}/start.
• →Nhấn Try it out.
• →Điền id
• (Tùy chọn) Điền winScale, winPosition, winSize nếu muốn tùy chỉnh cửa sổ.
• →Nhấn Execute.
• →Kiểm tra response success true → cửa sổ trình duyệt PionLogin sẽ bật lên với cấu hình profile đó.
• →Verify: Profile browserStatus chuyển sang OPENING khi gọi GET /api/profiles/{id}.

GET /api/profiles/{id}/close

3.8.1. Chức năng: Đóng profile theo ID được chỉ định.

• Nếu profile đang OPENING (cửa sổ trình duyệt đang chạy) → sẽ kill process browser và đóng cửa sổ.
• Nếu profile đã CLOSED → có thể trả thông báo "already closed" hoặc thành công mà không làm gì (tùy phiên bản).
• Sau khi close thành công, bạn có thể an toàn update, delete, hoặc force-delete profile mà không lo xung đột.

3.8.2.Parameters (Path Parameter – bắt buộc)

• id (string, required, path): ID của profile cần đóng.

3.8.3. Cách test nhanh (trong Swagger UI)

• → Mở Swagger docs của PionLogin.
• →Chọn GET /api/profiles/{id}/close.
• → Nhấn Try it out.
• → Điền id
• → Nhấn Execute.
• → Kiểm tra response success true → cửa sổ trình duyệt của profile sẽ đóng ngay lập tức.

QUÝ KHÁCH CẦN HỖ TRỢ THÌ NHẮN NGAY CHO PIONLOGIN NHÉ

Fanpage: pionlogin.net

Register now and contact customer service to get a free proxy IP

1. Business Environment

The rapid development of the Internet has led to an increasing demand for network access among more individual and corporate users .

When performing web crawling, data collection, overseas business development, and other operations, you often encounter problems such as IP blocking and slow access speeds. This is where IP proxy services come in, and Cliproxy, as a leader among them, provides users with a more efficient and secure solution.

2. Cliproxy’s core advantages

(1) Efficiency

1. Fast response : Cliproxy has a vast pool of IP resources distributed around the world. Through intelligent routing algorithms, it can quickly select the optimal IP node for access based on the user's request target, greatly reducing network latency and improving access speed.
2. High concurrency processing capability : For users who require a large number of concurrent requests, such as web crawler projects, Cliproxy can easily handle it. Its powerful server architecture and distributed deployment ensure stable operation under high concurrency conditions without request timeouts or failures.
3. Stable connection : Cliproxy uses advanced connection management technology to maintain a stable connection with the target server. Even in complex network environments, it can effectively reduce connection interruptions and improve the integrity and reliability of data transmission.

(2) Security

1. Anonymity protection : When using Cliproxy, the user's real IP address is hidden, and the target server only sees the IP address of the proxy server. This effectively protects the user's privacy and security, avoiding the risk of network attacks or information leaks caused by IP exposure.
2. Data encryption : Cliproxy supports multiple encryption protocols, such as HTTPS and SSL, to encrypt user data transmission. Even if the data is intercepted during transmission, attackers cannot obtain sensitive information, ensuring data security.
3. Anti-ban mechanism : To prevent users from being blocked by the target server due to frequent access, Cliproxy has an intelligent anti-ban mechanism. It can automatically change the IP address, adjust the access frequency and request header information, simulate the access behavior of normal users, and reduce the probability of being blocked.

(3) Cost-effectiveness

In the online proxy market, the balance between price and value is the key to user choice.

Cliproxy has a transparent, flexible and highly competitive pricing system. While meeting the needs of different users, it minimizes usage costs and becomes a representative of cost-effective proxy services.

Ultra -low unit price: Reduce entry and long-term use costs

Cliproxy has a significant advantage in the unit price of core services, especially for frequently used Socks5 proxy IPs, with a unit price as low as US$0.032/IP.

●ISP Static Residential Proxy: As low as $3 / 30 days, high-quality exclusive pure dual ISP, unlimited traffic, more suitable for businesses that require a stable IP location for a long time.

Compared with the same industry: The price is 30%-50% lower than that of mainstream competitors. Individual users doing small-scale data collection and small and medium-sized enterprises conducting basic online marketing do not need to bear high costs and can start their business with a very low threshold.

● Enterprise-level discounts: For large-scale demands (such as an enterprise package for 100,000 IPs), the unit price can be further locked at US$0.032/IP, taking into account massive resources and controllable costs, and adapting to complex scenarios such as large-scale data capture and multi-regional marketing.

● Data package: high cost-effectiveness + flexible adaptation to eliminate waste

In terms of traffic billing, Cliproxy breaks the industry convention of "expiration and invalidity" and launches a low-priced traffic plan of US$0.58/GB, and the traffic never expires.

For users with fluctuating traffic demands (such as periodic data collection and irregular overseas business testing), there is no need to worry about idleness and waste; traffic can be used flexibly according to the business rhythm.

The unit price of traffic is more than 20% lower than the industry average. Long-term use can save about 35 % of traffic costs, making every investment correspond to actual value.

Layered packages accurately match different user needs and achieve adaptive IP usage

Cliproxy designs differentiated packages for different groups, such as individuals, small teams, and enterprises, to avoid the cost waste of "buying more with less":

Individuals /small teams: Economical packages with low IP volume (e.g., 100-1000 IPs) + basic traffic are available to meet the needs of small crawlers, account management, etc., with a starting cost as low as tens of dollars.

● Enterprise users: High-capacity IP packages (more than 10,000) + ultra-large traffic combination, with exclusive technical support, adapted to large-scale business scenarios, the overall cost is 25% lower than separate purchases.

Transparent pricing + high-frequency discounts: no hidden costs, further lowering the threshold for use

● Pricing transparency: No hidden fees (such as IP reset fees or bandwidth surcharges). Package content, unit prices, and traffic rules are clearly marked, allowing users to accurately calculate costs and avoid "consumption traps";

● Limited-time promotions: During anniversary celebrations, quarterly promotions, and other periods, some packages are discounted by 50%-60%, allowing you to enjoy substantial savings on both short-term purchases and long-term renewals.

Register now and contact customer service to get a free proxy IP

3. Cliproxy's technical principles

Cliproxy implements IP proxy function based on proxy server technology.

When a user initiates a network request, the request is first sent to Cliproxy's proxy server, which then selects the appropriate IP node to forward the request to the target server based on preset rules and algorithms.

The target server returns the response data to the proxy server, and the proxy server forwards the data to the user.

In terms of technical implementation, Cliproxy uses a distributed architecture and load balancing technology. A large number of proxy servers are deployed around the world, forming a massive distributed network. Through a load balancing algorithm, user requests are evenly distributed across the proxy servers, improving the overall performance and availability of the system.

4. Application Scenarios of Cliproxy

(1) Web crawlers

Cliproxy is an essential tool for web crawlers. It helps crawlers overcome IP restrictions on target websites and achieve large-scale data collection. Its efficient and stable connections and intelligent anti-blocking mechanisms improve the efficiency and success rate of crawlers.

(II) Overseas business expansion

When businesses expand into overseas markets, they often need to access overseas websites and resources. However, due to geographical restrictions and network differences, direct access can be slow or unavailable. Cliproxy can easily resolve these issues, allowing businesses to quickly and reliably access overseas websites and conduct business activities.

3. Social Media Marketing

In social media marketing, companies need to manage multiple social media accounts to publish content, interact with followers, and more. To avoid being banned by social media platforms due to frequent activity, Cliproxy can be used to assign a different IP address to each account, simulating real user behavior and improving account security and stability.

5. Market Core

As an efficient and secure IP proxy service, Cliproxy provides powerful support for users' network access. Its efficiency meets users' needs for fast and stable network connections, while its security effectively protects users' privacy and data security.

Cliproxy has demonstrated excellent performance and value in various application scenarios. However, please be mindful of legal and compliant use, select the appropriate proxy type, and pay attention to the stability of the proxy service.

TIPS: Cliproxy supports more usage environments and methods, and is perfectly compatible with any fingerprint browser or third-party configuration tool on the market. If you have special needs and usage environments, please feel free to contact us for full technical support.

Try it now and contact support to get free proxy resources

Với tốc độ vượt trội và độ tin cậy cao, PIA S5 Proxy hỗ trợ quản lý đa tài khoản, tiếp thị trên mạng xã hội, thu thập và xác minh dữ liệu, đồng thời vượt qua các hạn chế địa lý. Bài viết này sẽ khám phá lý do tại sao PIA S5 Proxy là giải pháp proxy tốt nhất năm 2025 và hướng dẫn cấu hình PionLogin để tối ưu hiệu suất.

PIA S5 Proxy là gì?

PIA S5 Proxy là dịch vụ proxy dân dụng SOCKS5 thương mại lớn nhất thế giới, với hơn 350 triệu địa chỉ IP tại 200 địa điểm trên toàn thế giới. Dịch vụ này được thiết kế cho các tác vụ như thu thập dữ liệu, nghiên cứu thị trường, xác thực quảng cáo và vượt qua các hạn chế về địa lý. PIA S5 Proxy mang đến tốc độ, độ ổn định và hiệu suất vượt trội, trở thành một công cụ thiết yếu cho người chơi MMO và những người dùng khác cần proxy đáng tin cậy.

Tính Năng & Lợi Ích của PIA S5 Proxy

Mạng Proxy Toàn Cầu với 350M+ IPs
PIA S5 Proxy cung cấp hơn 350 triệu IP dân cư, đảm bảo khả năng truy cập toàn cầu và hiệu suất ổn định cho các tác vụ như thu thập dữ liệu và xác minh quảng cáo.

Cam Kết 99.9% Thời Gian Hoạt Động
PIA S5 Proxy đảm bảo 99.9% thời gian hoạt động, giảm thiểu thời gian chết cho các tác vụ quan trọng như thu thập dữ liệu web và kiểm tra quảng cáo.

Định Vị IP Chính Xác
Lọc IP theo quốc gia, tiểu bang, thành phố hoặc ISP để tối ưu hóa thu thập dữ liệu, SEO địa phương và kiểm tra quảng cáo khu vực.

Giao Thức SOCKS5 & HTTP(S) Nhanh, An Toàn
PIA S5 Proxy hỗ trợ cả SOCKS5 và HTTP(S), đảm bảo tốc độ nhanh và bảo mật cao, lý tưởng cho thu thập dữ liệu quy mô lớn và vượt qua các hạn chế địa lý.

Mã giảm giá độc quyền
Sử dụng mã giảm giá PIAdisof10 để tiết kiệm 10% cho proxy SOCKS5, giúp bạn tiết kiệm chi phí mà không làm giảm chất lượng dịch vụ.

Hoàn Tiền Cho IP Không Hợp Lệ
PIA S5 Proxy cung cấp chính sách hoàn tiền cho IP không hợp lệ, đảm bảo bạn chỉ trả cho proxy hoạt động.

Tích Hợp Dễ Dàng với Công Cụ và Nền Tảng
Dễ dàng tích hợp PIA S5 Proxy với các công cụ thu thập dữ liệu và nền tảng tự động hóa, giúp tối ưu hóa quy trình làm việc.

Hỗ Trợ Khách Hàng 24/7
PIA S5 Proxy cung cấp hỗ trợ khách hàng 24/7 để giải quyết mọi vấn đề, đảm bảo bạn luôn nhận được sự trợ giúp cần thiết.

Các Gói Proxy của PIA S5

SOCKS5 Proxy ($0.03/IP)
PIA S5 Proxy sử dụng SOCKS5, mang lại tốc độ nhanh hơn, bảo mật cao hơn và tính linh hoạt lớn hơn so với proxy HTTP truyền thống. SOCKS5 là lựa chọn lý tưởng cho duyệt web an toàn, thu thập dữ liệu và vượt qua các hạn chế địa lý.

Residential Proxy ($0.65/GB)
Sử dụng proxy dân dụng của PIA Proxy, bạn có thể dễ dàng vượt qua các hạn chế về mạng, nâng cao trải nghiệm chơi game và trở thành lựa chọn hàng đầu cho người chơi MMO.

• - Phiên sticky và quay vòng
• - Tỷ lệ thành công >99.9%
• - Geolocation miễn phí

Proxy Unlimited Traffic ($71/ngày)
PIA Proxy cung cấp proxy không giới hạn băng thông với máy chủ chuyên dụng, hỗ trợ thu thập dữ liệu quy mô lớn cho đào tạo LLM mà không lo phát sinh chi phí.

Static Residential Proxy ($5/tháng)
PIA Proxy cung cấp proxy residential tĩnh, lý tưởng cho các nhu cầu sử dụng IP cố định dài hạn. Các proxy này thích hợp cho thu thập dữ liệu lâu dài, quản lý nhiều tài khoản và các hoạt động cần IP ổn định.

Long-acting (ISP) Proxy ($0.22/IP)
PIA S5 Proxy chọn từng proxy ISP lâu dài từ nguồn đáng tin cậy, đảm bảo bạn không gặp vấn đề khi thu thập dữ liệu.

Cấu hình PionLogin với PIA S5 Proxy

Bước 1: Truy cập trang web chính thức của PIA S5 proxy, tải xuống và đăng nhập vào "PIA S5 Proxy Client". (Lấy proxy SOCKS5 làm ví dụ)

Bước 2: Nhấp vào "SOCKS5 Proxy" và lọc theo các tiêu chí như "Quốc gia/Khu vực" và "Thành phố".

Bước 3: Chọn bất kỳ địa chỉ IP nào, nhấp chuột phải vào địa chỉ IP, chọn "Chuyển tiếp cổng tới Proxy" và chọn cổng [ví dụ: 40004].

Bước 4: Mở PionLogin → Nhấp vào "Tạo Hồ sơ" → Chọn "Socks5" → Nhập trường "Proxy cục bộ" từ PIAProxy → Đặt Cổng thành 40004. Nhấp vào "Kiểm tra". Nếu hiển thị màu xanh lá cây, proxy đã được cấu hình thành công!

Bước 5: Nhấp vào "Tạo hồ sơ" để hoàn tất cài đặt proxy.

PIA S5 Proxy nổi bật với mạng lưới IP rộng lớn, thời gian hoạt động cao, khả năng định vị địa lý tiên tiến và hiệu suất ổn định. Đây là lựa chọn lý tưởng cho người dùng cần giải pháp proxy mạnh mẽ và linh hoạt cho thu thập dữ liệu, SEO và kiểm tra quảng cáo. Với mức giá cạnh tranh, hỗ trợ xuất sắc và hiệu suất vượt trội, PIA S5 Proxy là sự lựa chọn tuyệt vời cho người chơi MMO.

Website chính thức của PIAProxy: https://www.piaproxy.com/