TutuPP
69 أداة MCP + REST API كاملة

توثيق واجهة TutuPP

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

بدء سريع

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

1

إنشاء حساب

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

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 — واجهة سطر أوامر طرفية

إضافة (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

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

أنت： اطبع 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 الوصول إلى جميع النقاط أدناه، مغطّيًا كل وظائف الواجهة.

إدارة المستندات

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

ترميم الصور بالذكاء الاصطناعي

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

إدارة المستندات

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 تحديث الاسم المستعار للمستخدم

ترميم الصور بالذكاء الاصطناعي

restoration_preview تشغيل معاينة ترميم بالذكاء الاصطناعي على صورة
get_restoration جلب نتيجة مهمة الترميم بالذكاء الاصطناعي

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

list_api_keys سرد جميع مفاتيح API للمستخدم الحالي
create_api_key إنشاء مفتاح API جديد (يظهر المفتاح كاملًا مرة واحدة فقط)
revoke_api_key إلغاء مفتاح API محدّد

النظام

health_check التحقق من صحة الخدمة (قاعدة البيانات/بوابة الدفع/الإصدار)
get_auto_print_schedule جلب إعدادات نافذة الطباعة التلقائية

تقييمات الطلبات

submit_order_review إرسال تقييم طلب واحد (تقييم بـ 3 أبعاد + تعليق)؛ عديم التكرار عبر ON CONFLICT؛ الحدّ 5/س
batch_submit_order_reviews تقييم دفعي (حتى 20 · معاملة واحدة · ذري)؛ 5 نجوم بنقرة واحدة
list_my_order_reviews سرد تقييماتي (غلاف مُقسّم لصفحات)
get_order_review جلب تفاصيل تقييم واحد (شاملة الرد الرسمي)
mark_order_review_read تعليم الرد الرسمي كمقروء (CTE يمنع إعادة التنفيذ، ويقلّل عدّاد شارة 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 مفقود أو غير صالح
403
ممنوع العملية ممنوعة، صلاحيات غير كافية
404
المورد غير موجود معرّف الطلب/المستند/الصورة غير موجود
409
تعارض الصورة مرتبطة بطلب ولا يمكن حذفها
413
الملف كبير جدًا المستند أكبر من 50MB / الصورة أكبر من 120MB
422
قاعدة العمل غير مُستوفاة رصيد غير كافٍ، لا يمكن إلغاء الطلب
429
طلبات كثيرة جدًا تجاوز حدّ معدّل API
500
خطأ داخلي في الخادم أعد المحاولة لاحقًا أو تواصل مع الدعم
تحديد المعدّل: تُحمى فقط عمليات الكتابة الحسّاسة مثل تسجيل الدخول / التسجيل / رموز التحقّق من الهجمات؛ ولا يُفعَّل مع الاستخدام العادي، والعتبات قابلة للضبط في لوحة الإدارة. تحمل الاستجابات الحقل retry_after_seconds + الترويسة Retry-After.

هل أنت مستعد للبدء؟

سجّل حسابًا، وأنشئ مفتاح API، ودع الذكاء الاصطناعي يتولّى الطباعة.

سجّل الآن إدارة مفاتيح API