Mới! |Một lần gọi API, nhận dữ liệu sạch. Không cần scraper.Nhận 10,000 token miễn phí →

Nền tảng dành cho nhà phát triển

FineProxy API & MCP

Tự động hóa các thao tác proxy từ mã của bạn hoặc kết nối một agent AI. Xem những gì được hỗ trợ, các biện pháp bảo vệ áp dụng ở đâu và cách kiểm tra một tích hợp hiện có trước khi chuyển đổi nhà cung cấp.

REST API49 thao tác OpenAPI
Máy chủ MCP49 công cụ cho agent
Quyền truy cậpKhóa API có phạm vi quyền

Một nền tảng, hai cách tự động hóa

API và MCP sử dụng cùng các khóa FineProxy có phạm vi quyền và cung cấp cùng các quy trình cho khách hàng. Hãy chọn dựa trên đối tượng sẽ vận hành: ứng dụng của bạn hoặc một agent AI.

REST · OpenAPI 3.1

Tích hợp FineProxy vào ứng dụng của bạn

Sử dụng các endpoint HTTP đã được lập tài liệu từ backend, script, tác vụ CI, bảng điều khiển nội bộ hoặc quy trình không cần lập trình. Đặc tả client hiện tại có trong bảng điều khiển.

Phù hợp nhất khi mã của bạn cần:
  • Chạy các quy trình xác định mà không cần mô hình AI
  • Xác thực cấu trúc yêu cầu và phản hồi theo OpenAPI
  • Tự kiểm soát việc thử lại, hàng đợi, nhật ký và triển khai
Mở tài liệu API

JSON-RPC 2.0 · Streamable HTTP

Cấp quyền truy cập có kiểm soát cho agent AI

Kết nối Cursor, Claude, VS Code, Cline, n8n hoặc một client MCP khác với máy chủ FineProxy. Agent nhận được các công cụ được phạm vi quyền của khóa API cho phép.

Phù hợp nhất khi bạn muốn agent:
  • Kiểm tra lượng IP hiện có, dịch vụ, mức sử dụng và lịch sử hỗ trợ
  • Báo giá và thực hiện các thao tác dịch vụ đã được phê duyệt
  • Chẩn đoán lỗi và giải thích các thay đổi được đề xuất
Mở phần thiết lập MCP trong bảng điều khiển

Kiểm tra tích hợp hiện có trước khi di chuyển

Tải một tệp Markdown, đính kèm tệp đó cho agent lập trình cùng với kho mã của bạn và chạy prompt kiểm tra đã chuẩn bị sẵn. Lượt đầu tiên chỉ đọc: quy trình xác định khả năng tương thích, adapter, trở ngại và chính xác đoạn mã cần thay đổi.

Prompt kiểm tra di chuyển chỉ đọc
Đọc FineProxy Agent Pack đính kèm và kiểm tra kho mã này.

Không sửa đổi mã trong lượt đầu tiên.

Tìm mọi nơi nhà cung cấp proxy hiện tại được cấu hình hoặc gọi. So sánh từng quy trình với các khả năng đã được lập tài liệu của FineProxy. Báo cáo:
1. Các quy trình hoàn toàn tương thích.
2. Các quy trình cần adapter hoặc chuyển đổi dữ liệu.
3. Hành vi không được hỗ trợ hoặc chưa rõ.
4. Các quyền FineProxy API bắt buộc.
5. Chính xác các tệp và đường dẫn mã sẽ thay đổi.
6. Các thay đổi về xác thực và lưu trữ bí mật.
7. Kế hoạch di chuyển theo giai đoạn có phương án quay lui.
8. Các kiểm thử tích hợp cần thiết trước khi chuyển đổi.

Không tự tạo endpoint. Đánh dấu mọi nội dung chưa được Agent Pack hoặc đặc tả OpenAPI hiện tại xác nhận thành câu hỏi.

Quá trình kiểm tra cần xác minh

  1. 01Nơi nhà cung cấp hiện tại được khởi tạo và gọi
  2. 02Khác biệt về xác thực và lưu trữ bí mật
  3. 03Quy trình mua, gia hạn, hủy dịch vụ và cập nhật IP
  4. 04Định dạng danh sách proxy, giao thức, cổng và phương thức xác thực
  5. 05Lựa chọn quốc gia, danh sách IP cho phép và giới hạn kết nối
  6. 06Phân trang, thử lại, idempotency, lỗi và xử lý giới hạn tốc độ
  7. 07Các phần phụ thuộc vào thanh toán, phân tích mức sử dụng, hỗ trợ và webhook
  8. 08Kế hoạch di chuyển và kiểm thử theo từng tệp mà không sửa mã

Để triển khai ở cấp endpoint, hãy cung cấp thêm cho agent tệp OpenAPI hiện tại được tải từ bảng điều khiển của bạn. Agent Pack chủ ý không chứa thông tin xác thực hoặc dữ liệu tài khoản riêng tư.

Những gì bạn có thể tự động hóa

Lớp công khai giải thích các quy trình hoàn chỉnh thay vì mô tả lại từng endpoint. Hãy dùng đặc tả OpenAPI trực tiếp khi triển khai từng yêu cầu.

01

Mua và cấp phát

Khám phá lượng IP hiện có theo thời gian thực, tính toán chính xác cơ cấu quốc gia và đặt hàng từ ví trên bảng điều khiển.

  • Liệt kê các quốc gia khả dụng và lượng IP hiện có
  • Báo giá gói đa quốc gia mà không cam kết chi tiêu
  • Mua với cơ chế bảo vệ giá và khóa idempotency
02

Quản lý dịch vụ

Vận hành các dịch vụ đang hoạt động mà không cần chờ ticket hỗ trợ khi gói dịch vụ hỗ trợ thao tác được yêu cầu.

  • Gia hạn, tạm ngưng, khôi phục hoặc hủy dịch vụ
  • Thay thế hoặc thêm IP và cập nhật thông tin xác thực
  • Quản lý tự động gia hạn, danh sách IP cho phép và tiện ích bổ sung kết nối
03

Phân tích và chẩn đoán

Sử dụng dữ liệu đo từ xa của tài khoản và dịch vụ để điều tra tải, độ tin cậy và hành vi của đích đến.

  • Đọc tổng quan mức sử dụng và chuỗi thời gian
  • Kiểm tra các đích đến hàng đầu và danh mục lỗi
  • Nhận kết quả chẩn đoán và khuyến nghị vận hành
04

Thanh toán và hỗ trợ

Kết nối các thao tác proxy với quy trình tài chính và hỗ trợ liên quan.

  • Đọc hóa đơn và tải tệp PDF hóa đơn
  • Bắt đầu nạp tiền vào ví và kiểm tra trạng thái
  • Tạo, đọc, trả lời và đóng ticket hỗ trợ
05

Truy cập proxy

Truy xuất các cài đặt mà ứng dụng cần để kết nối qua proxy đã mua.

  • Đọc cấu hình kết nối proxy xoay vòng
  • Thay đổi tên đăng nhập và mật khẩu dịch vụ
  • Quản lý giới hạn kết nối theo từng IP trong danh sách cho phép
06

Sự kiện và tài khoản

Giữ cho các hệ thống bên ngoài được đồng bộ và kiểm tra thông tin tài khoản liên quan đến bảo mật.

  • Cấu hình webhook và xử lý việc chuyển giao
  • Đọc dữ liệu hồ sơ, IP của bên gọi và lịch sử đăng nhập
  • Quản lý khóa API với các quyền được chọn ở phạm vi hẹp

Những gì nền tảng sẽ không thực hiện

Tính năng tự động hóa của FineProxy được giới hạn có chủ đích. Quyền truy cập được xác định bởi khóa, gói dịch vụ, lượng IP hiện có và các bước kiểm tra an toàn rõ ràng.

Không truy cập ngoài phạm vi quyền được cấp

Công cụ hoặc endpoint không thể đọc hay thay đổi tài nguyên trừ khi khóa API có quyền bắt buộc.

Không chi tiêu nếu thiếu wallet:spend

Các thao tác mua, gia hạn và cập nhật IP có phí không khả dụng khi thiếu phạm vi quyền tài chính.

Không có thao tác phá hủy ngầm

Các thao tác không thể đảo ngược yêu cầu cờ xác nhận rõ ràng. Chúng không thể xảy ra như tác dụng phụ của một yêu cầu đọc.

Không truy cập mã nguồn qua MCP

FineProxy MCP vận hành tài khoản khách hàng. Để kiểm tra một script, agent lập trình của bạn cũng phải được cấp quyền truy cập vào script hoặc kho mã đó.

Không bảo đảm lượng IP không được hỗ trợ

Quốc gia và số lượng khả dụng được kiểm tra theo lượng IP hiện có. Tác vụ tự động không thể đặt mua lượng IP không có sẵn.

Không có API đối tác cho đối tác không hoạt động

Đặc tả dành cho đối tác và các endpoint báo cáo chỉ hiển thị khi tài khoản có trạng thái đối tác đang hoạt động.

Kết nối agent trong vài phút

Tạo khóa API riêng trong bảng điều khiển, chỉ chọn các phạm vi quyền agent cần và đặt cấu hình MCP vào client của bạn. Lưu khóa thật trong bí mật hoặc biến môi trường.

mcp.json
{
  "mcpServers": {
    "fineproxy": {
      "url": "https://fineproxy.org/account_new/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer fb_YOUR_API_KEY"
      }
    }
  }
}

OpenAPI 3.1

Sử dụng đặc tả trực tiếp để triển khai

Bảng điều khiển hiển thị đặc tả OpenAPI 3.1 dành cho client đã được tuyển chọn, ví dụ yêu cầu, schema phản hồi và các đoạn mã client được tạo. Đối tác đang hoạt động cũng nhận được một đặc tả riêng dành cho đối tác.

Xem tài liệu tham chiếu API tương tác

Chọn bộ quyền hữu ích nhỏ nhất

Quyền đọc và ghi được tách biệt. Bắt đầu với các phạm vi quyền chỉ đọc để khám phá và kiểm tra di chuyển, sau đó chỉ thêm quyền ghi hoặc quyền tài chính cho quy trình cần đến chúng.

customer:read

Đọc hồ sơ khách hàng và thông tin tài khoản.

customer:write

Cập nhật thông tin khách hàng.

wallet:read

Xem số dư và dữ liệu ví.

wallet:deposit

Tạo và theo dõi các khoản nạp vào ví.

wallet:spend

Cho phép tác vụ tự động chi tiêu tiền trong ví.

services:read

Xem dịch vụ, cài đặt proxy và trạng thái dịch vụ.

services:write

Tạo hoặc sửa đổi dịch vụ và tiện ích bổ sung.

tickets:read

Đọc ticket hỗ trợ và tin nhắn trong đó.

tickets:write

Tạo, trả lời, cập nhật hoặc đóng ticket.

catalog:read

Đọc sản phẩm, tùy chọn, quốc gia và lượng IP hiện có.

usage:read

Đọc dữ liệu sử dụng dịch vụ và phân tích chẩn đoán.

webhooks

Tạo và quản lý đăng ký webhook.

Các thiết lập bảo mật mặc định nên duy trì

  • Tạo khóa API riêng cho từng ứng dụng hoặc agent để có thể thu hồi độc lập.
  • Bắt đầu kiểm tra với các phạm vi quyền chỉ đọc. Chỉ thêm services:write hoặc wallet:spend sau khi xem xét kế hoạch được đề xuất.
  • Lưu khóa trong biến môi trường hoặc trình quản lý bí mật, không bao giờ lưu trong mã nguồn, prompt, ảnh chụp màn hình hoặc cấu hình MCP đã commit.
  • Sử dụng tổng số dự kiến đã được báo giá khi mua. Thay đổi giá sẽ khiến thao tác bị từ chối thay vì âm thầm tính phí cao hơn.
  • Tái sử dụng khóa idempotency khi thử lại một yêu cầu tài chính bị hết thời gian chờ để cùng một thao tác không thể bị tính phí hai lần.
  • Xem xét chữ ký webhook và lịch sử chuyển giao trước khi đưa sự kiện vào một quy trình quan trọng.

Bắt đầu bằng khả năng quan sát, sau đó mới cấp quyền kiểm soát

Quá trình kiểm tra chỉ đọc cho biết việc di chuyển có khả thi hay không mà không cấp quyền tài chính hoặc quyền ghi. Sau khi kế hoạch được phê duyệt, hãy tạo khóa production có phạm vi quyền hẹp và triển khai theo đặc tả OpenAPI trực tiếp.