TutuPP
69 MCP-Tools + vollständige REST-API

TutuPP API-Dokumentation

Nutzen Sie die REST-API oder das MCP-Protokoll, damit ein KI-Assistent Fotodruck, Dokumentdruck, Bestellverwaltung und alle weiteren Vorgänge direkt erledigt. Unterstützt 21 gängige KI-Clients, darunter Claude, Gemini, Codex und Copilot.

Schnellstart

In drei Schritten integrieren und sofort mit KI drucken.

1

Konto registrieren

Besuchen Sie die TutuPP-Website und registrieren Sie sich schnell mit einem SMS-Code.

2

API-Schlüssel erstellen

Erstellen Sie im Kontocenter auf der Seite „API-Schlüssel“ mit einem Klick einen Schlüssel und nutzen Sie ihn sofort.

3

Anfrage senden

Rufen Sie die REST-API mit Ihrem API-Schlüssel auf oder konfigurieren Sie ihn in einem KI-Client für MCP.

Authentifizierung

Alle API-Anfragen authentifizieren sich über den API-Schlüssel in einem HTTP-Header.

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

Antwortformat

Content-Type: application/json

MCP-Endpunkt

POST https://tutupp.com/api/mcp
Offene Plattform: Nach der Registrierung erstellen Sie einen API-Schlüssel ohne Freigabe und nutzen sofort alle API- und MCP-Funktionen.

MCP-Integration

MCP (Model Context Protocol) ist ein offenes Protokoll von Anthropic, mit dem KI-Assistenten externe Tools direkt aufrufen.

Nach der Konfiguration können Sie die KI per natürlicher Sprache den kompletten Ablauf „Dokument hochladen → Bestellung erstellen → mit Guthaben zahlen“ ausführen lassen.

Protokollinfo

Endpunkt：https://tutupp.com/api/mcp

Protokoll：JSON-RPC 2.0 over Streamable HTTP

Methoden：initialize · tools/list · tools/call

Datei-Upload：Unterstützt die multipart/form-data-Erweiterung (message part + file parts, kein base64, 100MB+) und den Standard application/json

Wählen Sie Ihren KI-Client 21

Claude Code — Terminal-CLI

Hinzufügen (Add)

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

Fügen Sie --scope user für global hinzu, --scope project nur für das aktuelle Projekt

Schlüssel ersetzen (Replace)

claude mcp remove tutupp && claude mcp add --transport http tutupp ...(neuer Schlüssel)

Entfernen (Remove)

claude mcp remove tutupp

KI-Gesprächsbeispiel

Sie： Drucke report.pdf von meinem Desktop, A4 Schwar-Weiß, und zahle mit meinem Guthaben

Die KI ruft automatisch auf:

1. upload_document → Datei hochladen

2. get_print_prices → A4-S/W-Preis abfragen

3. create_order → Bestellung erstellen

4. pay_with_balance → Mit Guthaben zahlen

AI： Fertig! Bestellung PP2026040612345, A4 S/W ×1, ¥0,50 vom Guthaben abgezogen.

REST-API-Referenz

Ein API-Schlüssel kann auf alle folgenden Endpunkte zugreifen und deckt alle Funktionen der Oberfläche ab.

Dokumentverwaltung

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

Fotoverwaltung

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

Bestellungen

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

Zahlung

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

Guthaben

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

Gutscheine

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

Lieferadressen

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

Für andere bestellen (Vorbestellungen)

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

Vorbestellungen teilen

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

Kundendienst

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

Regionen & Lieferung

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

Konfigurationsabfrage

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

KI-Fotorestaurierung

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

Benutzerinfo

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

Druckstatus

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

API-Schlüssel-Selbstverwaltung

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

Systemzustand

GET /api/health

MCP-Tool-Liste69

Alle folgenden Tools sind über das MCP-Protokoll aufrufbar; KI-Clients erkennen sie nach der Konfiguration automatisch.

Dokumentverwaltung

upload_document Dokument hochladen (PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX) — one of: file_url / content (base64) / file_path (curl)
list_documents Alle vom aktuellen Nutzer hochgeladenen Dokumente auflisten
get_document_info Dokumentdetails abrufen (Seitenzahl, Dateigröße usw.)
delete_document Dokument löschen (nur wenn nicht mit aktiver Bestellung verknüpft)

Fotoverwaltung

upload_photo Foto hochladen (JPG/PNG/WebP/HEIC) — one of: file_url / content (base64) / file_path (curl)
get_photo Fotodetails abrufen
delete_photo Foto löschen (nur wenn nicht mit aktiver Bestellung verknüpft)
check_photo_quality Foto-Druckqualität bei einer bestimmten Größe prüfen (DPI)

Bestellungen

create_order Druckauftrag erstellen
list_orders Alle Bestellungen des aktuellen Nutzers auflisten
get_order_status Bestellstatus und -details abfragen
cancel_order Bestellung stornieren (nur bei ausstehender Zahlung)
track_order Bestellinfo per Bestellnummer abrufen (öffentlich)
get_order_tracking Sendungsverfolgung der Bestellung abrufen

Zahlung & Guthaben

create_payment Drittanbieter-Zahlung erstellen (gibt payment_url zurück, im Browser öffnen zum Bezahlen)
pay_with_balance Bestellung mit Kontoguthaben bezahlen
get_payment_status Zahlungsstatus der Bestellung abfragen
create_topup Guthaben-Aufladeauftrag erstellen (gibt payment_url zurück)
get_balance Kontoguthaben abfragen (gesamt/gesperrt/verfügbar)
get_balance_transactions Guthaben-Transaktionsverlauf abfragen

Gutscheine

list_coupons Gutscheine des aktuellen Nutzers auflisten
get_available_coupons Verfügbare Gutscheine abrufen (Filter nach Betrag)
redeem_coupon Gutschein per Einlösecode einlösen

Lieferadressen

list_addresses Lieferadressen auflisten
create_address Lieferadresse hinzufügen
update_address Lieferadresse aktualisieren
delete_address Lieferadresse löschen
parse_address Adresstext intelligent parsen

Für andere bestellen (Vorbestellungen)

list_pre_orders Alle Vorbestellungen auflisten
create_pre_order Vorbestellung erstellen (Link teilen, damit andere einreichen)
get_pre_order Vorbestelldetails abrufen (inkl. aller Einreichungen)
update_pre_order Vorbestelleinstellungen aktualisieren
update_pre_order_status Vorbestellstatus ändern
review_submission Vorbestell-Einreichung prüfen
cancel_submission Eine Einreichung abbrechen

Vorbestellungen teilen

get_share_info Infos zum Freigabelink abrufen
submit_share_photos Fotos an einen Freigabelink senden
get_submission_status Einreichungsstatus und Fotodetails abfragen
list_my_submissions Alle Einreichungen unter einem Freigabelink auflisten

Kundendienst

list_after_sales Kundendienstvorgänge des aktuellen Nutzers auflisten
create_after_sales Kundendienstanfrage erstellen (Erstattung/Nachdruck/Neuversand)

Regionen & Lieferung

list_regions Regionsliste abfragen
get_region Regionsdetails und Unterregionen abrufen
get_region_tree Vollständigen Regionsbaum abrufen (Provinz → Stadt → Bezirk)
get_region_coverage Statistik der Agentenabdeckung abrufen
get_city_coverage Bezirksabdeckung innerhalb einer Stadt abrufen
get_agent_by_referral Agent per Empfehlungscode finden
check_express_delivery Prüfen, ob Same-Day-Lieferung möglich ist
get_shipping_config Liefer-/Versandkonfiguration abrufen (global)
get_shipping_carriers Zustellerliste abrufen (inkl. Zuschlag abgelegene Gebiete)
list_pickup_points Liste der Abholpunkte abfragen

Konfiguration & Status

get_print_prices Druckpreise + Mengenrabattstufen abrufen
get_print_options Verfügbare Größen und Papiertypen abrufen
get_printer_status Druckerstatus abfragen
get_queue_status Status der Druckwarteschlange abfragen

Benutzerinfo

get_profile Profil des aktuellen Nutzers abrufen
update_profile Nutzer-Nickname aktualisieren

KI-Fotorestaurierung

restoration_preview KI-Restaurierungsvorschau für ein Foto ausführen
get_restoration Ergebnis der KI-Restaurierungsaufgabe abrufen

API-Schlüssel-Selbstverwaltung

list_api_keys Alle API-Schlüssel des aktuellen Nutzers auflisten
create_api_key Neuen API-Schlüssel erstellen (vollständiger Schlüssel nur einmal sichtbar)
revoke_api_key Bestimmten API-Schlüssel widerrufen

System

health_check Dienstzustand prüfen (Datenbank/Zahlungs-Gateway/Version)
get_auto_print_schedule Einstellungen des Auto-Druck-Zeitfensters abrufen

Bestellbewertungen

submit_order_review Einzelne Bestellbewertung senden (3-Dimensionen-Rating + Kommentar); idempotent via ON CONFLICT; Limit 5/h
batch_submit_order_reviews Stapelbewertung (max. 20 · Einzeltransaktion · atomar); 5 Sterne mit einem Tipp
list_my_order_reviews Meine Bewertungen auflisten (paginierter Umschlag)
get_order_review Details einer einzelnen Bewertung abrufen (inkl. offizieller Antwort)
mark_order_review_read Offizielle Antwort als gelesen markieren (CTE verhindert Replay, senkt nav-Badge-Zähler)

Codebeispiele

Ein vollständiges Beispiel für den Ablauf „Preise abfragen → Datei hochladen → Bestellung erstellen → mit Guthaben zahlen“.

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

Typischer Ablauf

Datei hochladen Preise abfragen Bestellung erstellen Mit Guthaben zahlen Fertig

Fehlerbehandlung

Die API verwendet Standard-HTTP-Statuscodes; Fehlerantworten enthalten Fehlerinfos als JSON.

// Fehlerantwortformat
{
  "error": "Fehlerbeschreibung"
}
400
Ungültige Anfrageparameter Pflichtfelder fehlen, ungültiges Format
401
Nicht authentifiziert API-Schlüssel fehlt oder ungültig
403
Kein Zugriff Operation verboten, unzureichende Rechte
404
Ressource nicht gefunden Bestell-/Dokument-/Foto-ID existiert nicht
409
Konflikt Foto mit Bestellung verknüpft, Löschen nicht möglich
413
Datei zu groß Dokument über 50 MB / Foto über 120 MB
422
Geschäftsregel nicht erfüllt Guthaben unzureichend, Bestellung nicht stornierbar
429
Zu viele Anfragen API-Ratenlimit überschritten
500
Interner Serverfehler Bitte später erneut versuchen oder Support kontaktieren
Ratenbegrenzung: Nur sensible Schreibvorgänge wie Login / Registrierung / Verifizierungscodes sind gegen Angriffe geschützt; normale Nutzung löst sie nie aus, und Schwellenwerte sind im Admin-Bereich konfigurierbar. Antworten enthalten ein retry_after_seconds-Feld + einen Retry-After-Header.

Bereit loszulegen?

Registrieren Sie sich, erstellen Sie einen API-Schlüssel und lassen Sie die KI Ihre Druckaufträge erledigen.

Jetzt registrieren API-Schlüssel verwalten