TutuPP
69 MCP टूल + पूर्ण REST API

TutuPP API दस्तावेज़

REST API या MCP प्रोटोकॉल का उपयोग कर AI असिस्टेंट से फ़ोटो प्रिंट, दस्तावेज़ प्रिंट, ऑर्डर प्रबंधन आदि सभी संचालन सीधे कराएँ। Claude, Gemini, Codex, Copilot सहित 21 प्रमुख AI क्लाइंट समर्थित।

त्वरित शुरुआत

तीन चरणों में एकीकृत करें और तुरंत AI से प्रिंट शुरू करें।

1

खाता पंजीकरण

TutuPP वेबसाइट पर जाएँ और फ़ोन OTP से तुरंत पंजीकरण करें।

2

API Key बनाएँ

अकाउंट सेंटर के «API कुंजी» पेज पर एक क्लिक में कुंजी बनाएँ और तुरंत उपयोग करें।

3

अनुरोध भेजें

अपनी API Key से REST API कॉल करें, या MCP उपयोग हेतु किसी AI क्लाइंट में कॉन्फ़िगर करें।

प्रमाणीकरण

सभी API अनुरोध HTTP हेडर में API Key लेकर प्रमाणित होते हैं।

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

MCP टूल सूची69

नीचे दिए सभी टूल 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-आयाम रेटिंग + टिप्पणी); 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
संसाधन नहीं मिला ऑर्डर/दस्तावेज़/फ़ोटो ID मौजूद नहीं
409
विरोध फ़ोटो ऑर्डर से जुड़ी है, हटाई नहीं जा सकती
413
फ़ाइल बहुत बड़ी दस्तावेज़ 50MB से अधिक / फ़ोटो 120MB से अधिक
422
व्यावसायिक नियम अपूर्ण बैलेंस अपर्याप्त, ऑर्डर रद्द नहीं
429
बहुत अधिक अनुरोध API दर सीमा पार
500
सर्वर आंतरिक त्रुटि बाद में पुनः प्रयास करें या सहायता से संपर्क करें
रेट-लिमिट: केवल लॉगिन / रजिस्टर / वेरिफ़िकेशन कोड जैसी संवेदनशील राइट क्रियाओं को हमलों से बचाया जाता है; सामान्य उपयोग में कभी ट्रिगर नहीं होता, और थ्रेशोल्ड एडमिन कंसोल में कॉन्फ़िगर किए जा सकते हैं। प्रतिक्रियाओं में retry_after_seconds फ़ील्ड + Retry-After हेडर होता है।

शुरू करने के लिए तैयार?

खाता पंजीकृत करें, API Key बनाएँ, और AI को अपने प्रिंट कार्य सौंपें।

अभी पंजीकरण करें API कुंजियाँ प्रबंधित करें