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

เอกสาร API ของ TutuPrints

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

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

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

1

สมัครบัญชี

เยี่ยมชมเว็บไซต์ TutuPrints แล้วสมัครอย่างรวดเร็วด้วยรหัส 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 — mcs_desc_cli

เพิ่ม (Add)

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

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

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

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

นำออก (Remove)

claude mcp remove tutuprints

ตัวอย่างบทสนทนากับ 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

adt0

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

adt1

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

adt2

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

adt3

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

adt4

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

adt5

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

adt6

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

adt7

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

adt8

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

adt9

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

adt10

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

adt11

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

adt12

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

adt13

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

adt14

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

adt15

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

adt16

GET /api/health

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

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

adt17

upload_document add65
list_documents add66
get_document_info add67
delete_document add68

adt18

upload_photo add69
get_photo add70
delete_photo add71
check_photo_quality add72

adt19

create_order add73
list_orders add74
get_order_status add75
cancel_order add76
track_order add77
get_order_tracking add78

adt20

create_payment add79
pay_with_balance add80
get_payment_status add81
create_topup add82
get_balance add83
get_balance_transactions add84

adt21

list_coupons add85
get_available_coupons add86
redeem_coupon add87

adt22

list_addresses add88
create_address add89
update_address add90
delete_address add91
parse_address add92

adt23

list_pre_orders add93
create_pre_order add94
get_pre_order add95
update_pre_order add96
update_pre_order_status add97
review_submission add98
cancel_submission add99

adt24

get_share_info add100
submit_share_photos add101
get_submission_status add102
list_my_submissions add103

adt25

list_after_sales add104
create_after_sales add105

adt26

list_regions add106
get_region add107
get_region_tree add108
get_region_coverage add109
get_city_coverage add110
get_agent_by_referral add111
check_express_delivery add112
get_shipping_config add113
get_shipping_carriers add114
list_pickup_points add115

adt27

get_print_prices add116
get_print_options add117
get_printer_status add118
get_queue_status add119

adt28

get_profile add120
update_profile add121

adt29

restoration_preview add122
get_restoration add123
create_restore_share add_sh1
list_my_restore_shares add_sh2
revoke_restore_share add_sh3
claim_restore_share add_sh4

adt30

list_api_keys add124
create_api_key add125
revoke_api_key add126

adt31

health_check add127
get_auto_print_schedule add128

adt32

submit_order_review add129
batch_submit_order_reviews add130
list_my_order_reviews add131
get_order_review add132
mark_order_review_read add133

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

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

# ดูราคา
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
add134 ade0
401
add135 ade1
403
add136 ade2
404
add137 ade3
409
add138 ade4
413
add139 ade5
422
add140 ade6
429
add141 ade7
500
add142 ade8
การจำกัดอัตรา: ป้องกันการโจมตีเฉพาะการเขียนที่อ่อนไหว เช่น ล็อกอิน / สมัคร / รหัสยืนยัน การใช้งานปกติจะไม่ทริกเกอร์ และตั้งค่าเกณฑ์ได้ในคอนโซลผู้ดูแล การตอบกลับมีฟิลด์ retry_after_seconds + เฮดเดอร์ Retry-After

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

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

จัดการคีย์ API