TutuPP
69 công cụ MCP + REST API đầy đủ

Tài liệu API TutuPP

Dùng REST API hoặc giao thức MCP để trợ lý AI trực tiếp thực hiện in ảnh, in tài liệu, quản lý đơn hàng và mọi thao tác khác. Hỗ trợ 21 ứng dụng AI phổ biến gồm Claude, Gemini, Codex và Copilot.

Bắt đầu nhanh

Tích hợp trong ba bước và dùng AI để in ngay.

1

Đăng ký tài khoản

Truy cập trang TutuPP và đăng ký nhanh bằng mã xác minh qua điện thoại.

2

Tạo API Key

Trên trang «Khóa API» trong trung tâm tài khoản, tạo khóa bằng một cú nhấp và dùng ngay.

3

Gửi yêu cầu

Gọi REST API bằng API Key của bạn, hoặc cấu hình vào ứng dụng AI để dùng MCP.

Xác thực

Mọi yêu cầu API xác thực bằng cách gửi API Key trong HTTP header.

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

Định dạng phản hồi

Content-Type: application/json

Điểm cuối MCP

POST https://tutupp.com/api/mcp
Nền tảng mở: sau khi đăng ký, tạo API Key không cần phê duyệt và dùng ngay mọi tính năng API và MCP.

Tích hợp MCP

MCP (Model Context Protocol) là giao thức mở của Anthropic cho phép trợ lý AI gọi công cụ bên ngoài trực tiếp.

Sau khi cấu hình, bạn có thể dùng ngôn ngữ tự nhiên để AI chạy trọn quy trình «tải tài liệu → tạo đơn → thanh toán bằng số dư».

Thông tin giao thức

Điểm cuối：https://tutupp.com/api/mcp

Giao thức：JSON-RPC 2.0 over Streamable HTTP

Phương thức：initialize · tools/list · tools/call

Tải tệp lên：Hỗ trợ phần mở rộng multipart/form-data (message part + file parts, không base64, 100MB+) và chuẩn application/json

Chọn ứng dụng AI của bạn 21

Claude Code — CLI dòng lệnh

Thêm (Add)

claude mcp add --transport http tutupp https://tutupp.com/api/mcp --header "Authorization: Bearer tk_YOUR_API_KEY"

Thêm --scope user cho toàn cục, --scope project chỉ cho dự án hiện tại

Thay khóa (Replace)

claude mcp remove tutupp && claude mcp add --transport http tutupp ...(khóa mới)

Gỡ bỏ (Remove)

claude mcp remove tutupp

Ví dụ hội thoại AI

Bạn： In report.pdf trên desktop của tôi, A4 đen trắng, và thanh toán bằng số dư

AI tự động gọi:

1. upload_document → Tải tệp lên

2. get_print_prices → Tra giá A4 đen trắng

3. create_order → Tạo đơn

4. pay_with_balance → Thanh toán bằng số dư

AI： Xong! Đơn PP2026040612345, A4 đen trắng ×1, đã trừ ¥0,50 từ số dư của bạn.

Tham chiếu REST API

Một API Key có thể truy cập mọi endpoint bên dưới, bao phủ mọi tính năng của giao diện.

Quản lý tài liệu

POST /api/documents/upload
GET /api/documents
GET /api/documents/{id}
DELETE /api/documents/{id}

Quản lý ảnh

POST /api/photos/upload
GET /api/photos/{id}
DELETE /api/photos/{id}
GET /api/photos/{id}/quality-check?size={size}

Đơn hàng

POST /api/orders
GET /api/orders
GET /api/orders/{id}
PUT /api/orders/{id}/cancel
GET /api/orders/track/{order_no}
GET /api/orders/{id}/tracking

Thanh toán

POST /api/payment/create
POST /api/payment/balance
GET /api/payment/status/{order_id}

Số dư

GET /api/user/balance
POST /api/user/balance/topup
GET /api/user/balance/transactions

Phiếu giảm giá

GET /api/user/coupons
GET /api/user/coupons/available
POST /api/user/coupons/redeem

Địa chỉ giao hàng

GET /api/addresses
POST /api/addresses
PUT /api/addresses/{id}
DELETE /api/addresses/{id}
POST /api/addresses/parse

Đặt hộ (đặt trước)

GET /api/user/pre-orders
POST /api/user/pre-orders
GET /api/user/pre-orders/{id}
PUT /api/user/pre-orders/{id}
PUT /api/user/pre-orders/{id}/status
POST /api/user/pre-orders/{id}/submissions/{sid}/review
PUT /api/user/pre-orders/{id}/submissions/{sid}/cancel

Chia sẻ đặt trước

GET /api/share/{code}
POST /api/share/{code}/submit
GET /api/share/{code}/submissions/{sid}
GET /api/share/{code}/my-submissions

Hậu mãi

GET /api/user/after-sales
POST /api/after-sales

Khu vực & giao hàng

GET /api/regions
GET /api/regions/{id}
GET /api/regions/tree
GET /api/regions/coverage
GET /api/regions/{city_id}/city-coverage
GET /api/regions/{id}/express-delivery
GET /api/regions/{id}/pickup-points
GET /api/agents/referral/{code}
GET /api/shipping/config
GET /api/shipping/carriers

Tra cứu cấu hình

GET /api/prices
GET /api/print-options/sizes
GET /api/print-options/paper-types

Phục hồi ảnh bằng AI

POST /api/photos/{id}/restore
GET /api/restorations/{id}

Thông tin người dùng

GET /api/auth/me
PUT /api/auth/me

Trạng thái in

GET /api/printer/status
GET /api/print-queue/status
GET /api/orders/auto-print-schedule

Tự quản lý khóa API

GET /api/user/api-keys
POST /api/user/api-keys
DELETE /api/user/api-keys/{id}

Tình trạng hệ thống

GET /api/health

Danh sách công cụ MCP69

Mọi công cụ bên dưới có thể gọi qua giao thức MCP; ứng dụng AI tự phát hiện sau khi cấu hình.

Quản lý tài liệu

upload_document Tải lên tài liệu (PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX) — one of: file_url / content (base64) / file_path (curl)
list_documents Liệt kê mọi tài liệu người dùng hiện tại đã tải lên
get_document_info Lấy chi tiết tài liệu (số trang, kích thước tệp, v.v.)
delete_document Xóa tài liệu (chỉ khi chưa gắn với đơn đang hoạt động)

Quản lý ảnh

upload_photo Tải lên ảnh (JPG/PNG/WebP/HEIC) — one of: file_url / content (base64) / file_path (curl)
get_photo Lấy chi tiết ảnh
delete_photo Xóa ảnh (chỉ khi chưa gắn với đơn đang hoạt động)
check_photo_quality Kiểm tra chất lượng in ảnh ở kích thước cho trước (DPI)

Đơn hàng

create_order Tạo đơn in
list_orders Liệt kê mọi đơn của người dùng hiện tại
get_order_status Truy vấn trạng thái và chi tiết đơn
cancel_order Hủy đơn (chỉ khi chờ thanh toán)
track_order Tra thông tin đơn theo mã (công khai)
get_order_tracking Lấy thông tin theo dõi vận chuyển của đơn

Thanh toán & số dư

create_payment Tạo thanh toán bên thứ ba (trả về payment_url, mở trình duyệt để trả)
pay_with_balance Thanh toán đơn bằng số dư tài khoản
get_payment_status Truy vấn trạng thái thanh toán đơn
create_topup Tạo đơn nạp số dư (trả về payment_url)
get_balance Truy vấn số dư tài khoản (tổng/đóng băng/khả dụng)
get_balance_transactions Truy vấn lịch sử giao dịch số dư

Phiếu giảm giá

list_coupons Liệt kê phiếu của người dùng hiện tại
get_available_coupons Lấy phiếu khả dụng (lọc theo số tiền)
redeem_coupon Nhận phiếu qua mã đổi

Địa chỉ giao hàng

list_addresses Liệt kê địa chỉ giao hàng
create_address Thêm địa chỉ giao hàng
update_address Cập nhật địa chỉ giao hàng
delete_address Xóa địa chỉ giao hàng
parse_address Phân tích văn bản địa chỉ thông minh

Đặt hộ (đặt trước)

list_pre_orders Liệt kê mọi đặt trước
create_pre_order Tạo đặt trước (chia sẻ liên kết để người khác gửi)
get_pre_order Lấy chi tiết đặt trước (gồm mọi bài gửi)
update_pre_order Cập nhật cài đặt đặt trước
update_pre_order_status Đổi trạng thái đặt trước
review_submission Duyệt bài gửi đặt trước
cancel_submission Hủy một bài gửi

Chia sẻ đặt trước

get_share_info Lấy thông tin liên kết chia sẻ
submit_share_photos Gửi ảnh tới liên kết chia sẻ
get_submission_status Truy vấn trạng thái bài gửi và chi tiết ảnh
list_my_submissions Liệt kê mọi bài gửi dưới một liên kết chia sẻ

Hậu mãi

list_after_sales Liệt kê hồ sơ hậu mãi của người dùng hiện tại
create_after_sales Tạo yêu cầu hậu mãi (hoàn tiền/in lại/gửi lại)

Khu vực & giao hàng

list_regions Truy vấn danh sách khu vực
get_region Lấy chi tiết khu vực và khu vực con
get_region_tree Lấy cây khu vực đầy đủ (tỉnh → thành phố → quận/huyện)
get_region_coverage Lấy thống kê phủ sóng đại lý
get_city_coverage Lấy phủ sóng quận huyện trong thành phố
get_agent_by_referral Tìm đại lý theo mã giới thiệu
check_express_delivery Kiểm tra có hỗ trợ giao trong ngày không
get_shipping_config Lấy cấu hình giao/vận chuyển (toàn cục)
get_shipping_carriers Lấy danh sách hãng vận chuyển (gồm phụ phí khu vực xa)
list_pickup_points Truy vấn danh sách điểm nhận hàng

Cấu hình & trạng thái

get_print_prices Lấy giá in + các bậc chiết khấu số lượng
get_print_options Lấy kích thước và loại giấy khả dụng
get_printer_status Truy vấn trạng thái máy in
get_queue_status Truy vấn trạng thái hàng đợi in

Thông tin người dùng

get_profile Lấy hồ sơ người dùng hiện tại
update_profile Cập nhật biệt danh người dùng

Phục hồi ảnh bằng AI

restoration_preview Chạy xem trước phục hồi AI cho ảnh
get_restoration Lấy kết quả tác vụ phục hồi AI

Tự quản lý khóa API

list_api_keys Liệt kê mọi API Key của người dùng hiện tại
create_api_key Tạo API Key mới (khóa đầy đủ chỉ hiện một lần)
revoke_api_key Thu hồi một API Key cụ thể

Hệ thống

health_check Kiểm tra sức khỏe dịch vụ (cơ sở dữ liệu/cổng thanh toán/phiên bản)
get_auto_print_schedule Lấy cài đặt khung giờ in tự động

Đánh giá đơn hàng

submit_order_review Gửi một đánh giá đơn (chấm điểm 3 chiều + bình luận); idempotent qua ON CONFLICT; giới hạn 5/giờ
batch_submit_order_reviews Đánh giá hàng loạt (tối đa 20 · một giao dịch · nguyên tử); 5 sao một chạm
list_my_order_reviews Liệt kê đánh giá của tôi (phong bì phân trang)
get_order_review Lấy chi tiết một đánh giá (gồm phản hồi chính thức)
mark_order_review_read Đánh dấu phản hồi chính thức đã đọc (CTE chống phát lại, giảm số đếm badge nav)

Ví dụ mã

Ví dụ đầy đủ quy trình «tra giá → tải tệp → tạo đơn → thanh toán bằng số dư».

# 查询打印价格
curl https://tutupp.com/api/prices \
  -H "Authorization: Bearer tk_YOUR_API_KEY"

# 上传文档
curl -X POST https://tutupp.com/api/documents/upload \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -F "file=@report.pdf"

# 创建订单
curl -X POST https://tutupp.com/api/orders \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [{
      "document_id": "uuid-here",
      "size": "A4",
      "paper_type": "matte",
      "quantity": 1
    }],
    "delivery_method": "pickup"
  }'

# 余额支付
curl -X POST https://tutupp.com/api/payment/balance \
  -H "Authorization: Bearer tk_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_id": "uuid-here"}'

Quy trình điển hình

Tải tệp Tra giá Tạo đơn Thanh toán bằng số dư Xong

Xử lý lỗi

API dùng mã trạng thái HTTP chuẩn; phản hồi lỗi chứa thông tin lỗi ở dạng JSON.

// Định dạng phản hồi lỗi
{
  "error": "Mô tả lỗi"
}
400
Tham số yêu cầu sai Thiếu trường bắt buộc, sai định dạng
401
Chưa xác thực Thiếu hoặc sai API Key
403
Bị cấm Thao tác bị cấm, thiếu quyền
404
Không tìm thấy tài nguyên ID đơn/tài liệu/ảnh không tồn tại
409
Xung đột Ảnh đã gắn với đơn, không thể xóa
413
Tệp quá lớn Tài liệu trên 50MB / ảnh trên 120MB
422
Không thỏa quy tắc nghiệp vụ Số dư không đủ, không thể hủy đơn
429
Quá nhiều yêu cầu Vượt giới hạn tần suất API
500
Lỗi máy chủ nội bộ Vui lòng thử lại sau hoặc liên hệ hỗ trợ
Giới hạn tần suất: chỉ các thao tác ghi nhạy cảm như đăng nhập / đăng ký / mã xác minh được bảo vệ khỏi tấn công; sử dụng bình thường không bao giờ kích hoạt, và ngưỡng có thể cấu hình trong bảng quản trị. Phản hồi kèm trường retry_after_seconds + header Retry-After.

Sẵn sàng bắt đầu?

Đăng ký tài khoản, tạo API Key và để AI lo việc in ấn cho bạn.

Đăng ký ngay Quản lý khóa API