TutuPrints
73 أداة MCP + REST API كاملة

توثيق واجهة TutuPrints

استخدم واجهة REST أو بروتوكول MCP لتمكين مساعد الذكاء الاصطناعي من تنفيذ طباعة الصور والمستندات وإدارة الطلبات وكل العمليات مباشرةً. يدعم 21 عميل ذكاء اصطناعي رئيسيًا، منها Claude وGemini وCodex وCopilot.

بدء سريع

ادمج في ثلاث خطوات وابدأ باستخدام الذكاء الاصطناعي للطباعة فورًا.

1

إنشاء حساب

زر موقع TutuPrints وسجّل بسرعة برمز تحقّق عبر الهاتف.

2

إنشاء مفتاح API

في صفحة «مفاتيح API» بمركز الحساب، أنشئ مفتاحًا بنقرة واحدة واستخدمه فورًا.

3

إرسال طلب

استدعِ واجهة REST بمفتاح API، أو اضبطه في عميل ذكاء اصطناعي لاستخدام MCP.

المصادقة

تُصادَق جميع طلبات API عبر تمرير مفتاح API في ترويسة HTTP.

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

تنسيق الاستجابة

Content-Type: application/json

نقطة نهاية MCP

POST https://tutupp.com/api/mcp
منصّة مفتوحة: بعد التسجيل أنشئ مفتاح API دون موافقة واستخدم كل ميزات API وMCP فورًا.

تكامل MCP

MCP (Model Context Protocol) بروتوكول مفتوح من Anthropic يتيح لمساعدي الذكاء الاصطناعي استدعاء أدوات خارجية مباشرةً.

بعد الإعداد، يمكنك بلغة طبيعية جعل الذكاء الاصطناعي ينفّذ التدفّق الكامل «رفع مستند ← إنشاء طلب ← الدفع بالرصيد».

معلومات البروتوكول

نقطة النهاية: 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

اختر عميل الذكاء الاصطناعي 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

مثال محادثة مع الذكاء الاصطناعي

أنت: اطبع report.pdf من سطح المكتب، A4 أبيض وأسود، وادفع من رصيدي

يستدعي الذكاء الاصطناعي تلقائيًا:

1. upload_document → رفع الملف

2. get_print_prices → الاستعلام عن سعر A4 أبيض وأسود

3. create_order → إنشاء الطلب

4. pay_with_balance → الدفع بالرصيد

AI: تم! الطلب PP2026040612345، A4 أبيض وأسود ×1، وخُصم ¥0.50 من رصيدك.

مرجع واجهة REST

يمكن لمفتاح API الوصول إلى جميع النقاط أدناه، مغطّيًا كل وظائف الواجهة.

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؛ ويكتشفها عملاء الذكاء الاصطناعي تلقائيًا بعد الإعداد.

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، ودع الذكاء الاصطناعي يتولّى الطباعة.

إدارة مفاتيح API