TutuPP
เครื่องมือ MCP 69 รายการ + REST API ครบถ้วน

เอกสาร API ของ TutuPP

ใช้ REST API หรือโปรโตคอล MCP เพื่อให้ผู้ช่วย AI ดำเนินการพิมพ์รูป พิมพ์เอกสาร จัดการคำสั่งซื้อ และการดำเนินการทั้งหมดได้โดยตรง รองรับไคลเอนต์ AI หลัก 21 ตัว รวมถึง Claude, Gemini, Codex และ Copilot

เริ่มต้นอย่างรวดเร็ว

เชื่อมต่อในสามขั้นตอนแล้วเริ่มใช้ AI พิมพ์ได้ทันที

1

สมัครบัญชี

เยี่ยมชมเว็บไซต์ TutuPP แล้วสมัครอย่างรวดเร็วด้วยรหัส OTP ทางมือถือ

2

สร้าง API Key

ที่หน้า «คีย์ API» ในศูนย์บัญชี สร้างคีย์ด้วยคลิกเดียวและใช้ได้ทันที

3

ส่งคำขอ

เรียก REST API ด้วย API Key ของคุณ หรือกำหนดค่าในไคลเอนต์ AI เพื่อใช้ MCP

วิธีการยืนยันตัวตน

คำขอ API ทั้งหมดยืนยันตัวตนโดยส่ง API Key ใน HTTP header

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

รูปแบบการตอบกลับ

Content-Type: application/json

จุดเชื่อมต่อ MCP

POST https://tutupp.com/api/mcp
แพลตฟอร์มเปิด: หลังสมัคร สร้าง API Key ได้โดยไม่ต้องอนุมัติ และใช้ฟีเจอร์ API และ MCP ทั้งหมดได้ทันที

การผสาน MCP

MCP (Model Context Protocol) เป็นโปรโตคอลเปิดจาก Anthropic ที่ให้ผู้ช่วย AI เรียกเครื่องมือภายนอกได้โดยตรง

เมื่อกำหนดค่าแล้ว คุณสามารถใช้ภาษาธรรมชาติสั่งให้ AI ทำครบขั้นตอน «อัปโหลดเอกสาร → สร้างคำสั่งซื้อ → ชำระด้วยยอดเงิน»

ข้อมูลโปรโตคอล

จุดเชื่อมต่อ：https://tutupp.com/api/mcp

โปรโตคอล：JSON-RPC 2.0 over Streamable HTTP

เมท็อด：initialize · tools/list · tools/call

อัปโหลดไฟล์：รองรับส่วนขยาย multipart/form-data (message part + file parts, ไม่ต้อง base64, 100MB+) และมาตรฐาน application/json

เลือกไคลเอนต์ AI ของคุณ 21

Claude Code — CLI เทอร์มินัล

เพิ่ม (Add)

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

เพิ่ม --scope user เพื่อใช้ทั่วระบบ, --scope project เฉพาะโปรเจกต์ปัจจุบัน

เปลี่ยนคีย์ (Replace)

claude mcp remove tutupp && claude mcp add --transport http tutupp ...(คีย์ใหม่)

นำออก (Remove)

claude mcp remove tutupp

ตัวอย่างบทสนทนากับ AI

คุณ： พิมพ์ report.pdf จากเดสก์ท็อป A4 ขาวดำ และชำระด้วยยอดเงินของฉัน

AI เรียกใช้อัตโนมัติ:

1. upload_document → อัปโหลดไฟล์

2. get_print_prices → สอบถามราคา A4 ขาวดำ

3. create_order → สร้างคำสั่งซื้อ

4. pay_with_balance → ชำระด้วยยอดเงิน

AI： เสร็จแล้ว! คำสั่งซื้อ PP2026040612345, A4 ขาวดำ 1 ชุด หัก ¥0.50 จากยอดเงินของคุณ

อ้างอิง REST API

API Key เข้าถึงทุกเอนด์พอยต์ด้านล่างได้ ครอบคลุมทุกฟีเจอร์ของ UI

การจัดการเอกสาร

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

การจัดการรูปภาพ

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

คำสั่งซื้อ

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

การชำระเงิน

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

ยอดเงิน

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

คูปอง

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

ที่อยู่จัดส่ง

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

สั่งแทนผู้อื่น (พรีออเดอร์)

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

แชร์พรีออเดอร์

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

บริการหลังการขาย

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

พื้นที่และการจัดส่ง

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

สอบถามการตั้งค่า

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

การฟื้นฟูภาพด้วย AI

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

ข้อมูลผู้ใช้

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

สถานะการพิมพ์

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

จัดการคีย์ API ด้วยตนเอง

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

สุขภาพระบบ

GET /api/health

รายการเครื่องมือ MCP69

เครื่องมือทั้งหมดด้านล่างเรียกใช้ผ่านโปรโตคอล MCP ได้ ไคลเอนต์ AI จะค้นพบอัตโนมัติเมื่อกำหนดค่าแล้ว

การจัดการเอกสาร

upload_document อัปโหลดเอกสาร (PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX) — one of: file_url / content (base64) / file_path (curl)
list_documents แสดงเอกสารทั้งหมดที่ผู้ใช้ปัจจุบันอัปโหลด
get_document_info ดูรายละเอียดเอกสาร (จำนวนหน้า ขนาดไฟล์ ฯลฯ)
delete_document ลบเอกสาร (เฉพาะที่ไม่ผูกกับคำสั่งซื้อที่ใช้งาน)

การจัดการรูปภาพ

upload_photo อัปโหลดรูปภาพ (JPG/PNG/WebP/HEIC) — one of: file_url / content (base64) / file_path (curl)
get_photo ดูรายละเอียดรูปภาพ
delete_photo ลบรูปภาพ (เฉพาะที่ไม่ผูกกับคำสั่งซื้อที่ใช้งาน)
check_photo_quality ตรวจคุณภาพการพิมพ์รูปที่ขนาดที่กำหนด (DPI)

คำสั่งซื้อ

create_order สร้างคำสั่งซื้อพิมพ์
list_orders แสดงคำสั่งซื้อทั้งหมดของผู้ใช้ปัจจุบัน
get_order_status สอบถามสถานะและรายละเอียดคำสั่งซื้อ
cancel_order ยกเลิกคำสั่งซื้อ (เฉพาะสถานะรอชำระเงิน)
track_order ค้นหาข้อมูลคำสั่งซื้อด้วยหมายเลข (สาธารณะ)
get_order_tracking ดูข้อมูลติดตามการจัดส่งของคำสั่งซื้อ

การชำระเงินและยอดเงิน

create_payment สร้างการชำระเงินบุคคลที่สาม (คืน payment_url เปิดในเบราว์เซอร์เพื่อชำระ)
pay_with_balance ชำระคำสั่งซื้อด้วยยอดเงินในบัญชี
get_payment_status สอบถามสถานะการชำระเงินของคำสั่งซื้อ
create_topup สร้างคำสั่งเติมยอดเงิน (คืน payment_url)
get_balance สอบถามยอดเงินบัญชี (รวม/แช่แข็ง/ใช้ได้)
get_balance_transactions สอบถามประวัติธุรกรรมยอดเงิน

คูปอง

list_coupons แสดงคูปองของผู้ใช้ปัจจุบัน
get_available_coupons ดูคูปองที่ใช้ได้ (กรองตามจำนวนเงิน)
redeem_coupon รับคูปองด้วยรหัสแลก

ที่อยู่จัดส่ง

list_addresses แสดงรายการที่อยู่จัดส่ง
create_address เพิ่มที่อยู่จัดส่ง
update_address อัปเดตที่อยู่จัดส่ง
delete_address ลบที่อยู่จัดส่ง
parse_address แยกวิเคราะห์ข้อความที่อยู่อัตโนมัติ

สั่งแทนผู้อื่น (พรีออเดอร์)

list_pre_orders แสดงพรีออเดอร์ทั้งหมด
create_pre_order สร้างพรีออเดอร์ (แชร์ลิงก์ให้ผู้อื่นส่ง)
get_pre_order ดูรายละเอียดพรีออเดอร์ (รวมทุกการส่ง)
update_pre_order อัปเดตการตั้งค่าพรีออเดอร์
update_pre_order_status เปลี่ยนสถานะพรีออเดอร์
review_submission ตรวจการส่งพรีออเดอร์
cancel_submission ยกเลิกการส่งรายการหนึ่ง

แชร์พรีออเดอร์

get_share_info ดูข้อมูลลิงก์แชร์
submit_share_photos ส่งรูปไปยังลิงก์แชร์
get_submission_status สอบถามสถานะการส่งและรายละเอียดรูป
list_my_submissions แสดงการส่งทั้งหมดภายใต้ลิงก์แชร์

บริการหลังการขาย

list_after_sales แสดงประวัติหลังการขายของผู้ใช้ปัจจุบัน
create_after_sales สร้างคำขอหลังการขาย (คืนเงิน/พิมพ์ใหม่/ส่งใหม่)

พื้นที่และการจัดส่ง

list_regions สอบถามรายการพื้นที่
get_region ดูรายละเอียดพื้นที่และพื้นที่ย่อย
get_region_tree ดึงแผนผังพื้นที่ทั้งหมด (มณฑล → เมือง → เขต)
get_region_coverage ดึงสถิติความครอบคลุมตัวแทน
get_city_coverage ดึงความครอบคลุมของเขตในเมือง
get_agent_by_referral ค้นหาตัวแทนด้วยรหัสแนะนำ
check_express_delivery ตรวจว่ารองรับการส่งภายในวันหรือไม่
get_shipping_config ดึงการตั้งค่าค่าจัดส่ง (ทั่วไป)
get_shipping_carriers ดึงรายการบริษัทขนส่ง (รวมค่าพื้นที่ห่างไกล)
list_pickup_points สอบถามรายการจุดรับสินค้า

การตั้งค่าและสถานะ

get_print_prices ดึงราคาพิมพ์ + ขั้นส่วนลดตามจำนวน
get_print_options ดึงขนาดและชนิดกระดาษที่ใช้ได้
get_printer_status สอบถามสถานะเครื่องพิมพ์
get_queue_status สอบถามสถานะคิวการพิมพ์

ข้อมูลผู้ใช้

get_profile ดึงโปรไฟล์ผู้ใช้ปัจจุบัน
update_profile อัปเดตชื่อเล่นผู้ใช้

การฟื้นฟูภาพด้วย AI

restoration_preview เรียกใช้พรีวิวการฟื้นฟูด้วย AI กับรูป
get_restoration ดึงผลงานฟื้นฟูด้วย AI

จัดการคีย์ API ด้วยตนเอง

list_api_keys แสดง API Key ทั้งหมดของผู้ใช้ปัจจุบัน
create_api_key สร้าง API Key ใหม่ (แสดงคีย์เต็มเพียงครั้งเดียว)
revoke_api_key เพิกถอน API Key ที่ระบุ

ระบบ

health_check ตรวจสุขภาพบริการ (ฐานข้อมูล/เกตเวย์ชำระเงิน/เวอร์ชัน)
get_auto_print_schedule ดึงการตั้งค่าช่วงเวลาพิมพ์อัตโนมัติ

รีวิวคำสั่งซื้อ

submit_order_review ส่งรีวิวคำสั่งซื้อเดี่ยว (คะแนน 3 มิติ + ความเห็น); idempotent ด้วย ON CONFLICT; จำกัด 5/ชม.
batch_submit_order_reviews รีวิวเป็นชุด (สูงสุด 20 · ธุรกรรมเดียว · อะตอมมิก); 5 ดาวแตะเดียว
list_my_order_reviews แสดงรีวิวของฉัน (ซองแบบแบ่งหน้า)
get_order_review ดูรายละเอียดรีวิวเดี่ยว (รวมคำตอบทางการ)
mark_order_review_read ทำเครื่องหมายคำตอบทางการว่าอ่านแล้ว (CTE กันการรีเพลย์ ลดตัวนับ badge nav)

ตัวอย่างโค้ด

ตัวอย่างครบขั้นตอน «สอบถามราคา → อัปโหลดไฟล์ → สร้างคำสั่งซื้อ → ชำระด้วยยอดเงิน»

# 查询打印价格
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"}'

เวิร์กโฟลว์ทั่วไป

อัปโหลดไฟล์ สอบถามราคา สร้างคำสั่งซื้อ ชำระด้วยยอดเงิน เสร็จ

การจัดการข้อผิดพลาด

API ใช้รหัสสถานะ HTTP มาตรฐาน การตอบกลับข้อผิดพลาดมีข้อมูลข้อผิดพลาดในรูปแบบ JSON

// รูปแบบการตอบกลับข้อผิดพลาด
{
  "error": "คำอธิบายข้อผิดพลาด"
}
400
พารามิเตอร์คำขอไม่ถูกต้อง ขาดฟิลด์ที่จำเป็น รูปแบบไม่ถูกต้อง
401
ยังไม่ยืนยันตัวตน ไม่มี API Key หรือไม่ถูกต้อง
403
ไม่มีสิทธิ์ การดำเนินการถูกห้าม สิทธิ์ไม่พอ
404
ไม่พบทรัพยากร ไม่มี ID คำสั่งซื้อ/เอกสาร/รูปภาพ
409
ขัดแย้ง รูปผูกกับคำสั่งซื้อ ลบไม่ได้
413
ไฟล์ใหญ่เกินไป เอกสารเกิน 50MB / รูปเกิน 120MB
422
ไม่เป็นไปตามกฎธุรกิจ ยอดเงินไม่พอ ยกเลิกคำสั่งซื้อไม่ได้
429
คำขอบ่อยเกินไป เกินขีดจำกัดอัตรา API
500
ข้อผิดพลาดภายในเซิร์ฟเวอร์ โปรดลองใหม่ภายหลังหรือติดต่อฝ่ายสนับสนุน
การจำกัดอัตรา: ป้องกันการโจมตีเฉพาะการเขียนที่อ่อนไหว เช่น ล็อกอิน / สมัคร / รหัสยืนยัน การใช้งานปกติจะไม่ทริกเกอร์ และตั้งค่าเกณฑ์ได้ในคอนโซลผู้ดูแล การตอบกลับมีฟิลด์ retry_after_seconds + เฮดเดอร์ Retry-After

พร้อมเริ่มหรือยัง?

สมัครบัญชี สร้าง API Key แล้วให้ AI จัดการงานพิมพ์ของคุณ

สมัครเลย จัดการคีย์ API