TutuPP
69 alat MCP + REST API lengkap

Dokumentasi API TutuPP

Gunakan REST API atau protokol MCP agar asisten AI langsung menangani cetak foto, cetak dokumen, manajemen pesanan, dan semua operasi lainnya. Mendukung 21 klien AI populer termasuk Claude, Gemini, Codex, dan Copilot.

Mulai cepat

Integrasikan dalam tiga langkah dan langsung gunakan AI untuk mencetak.

1

Daftar akun

Kunjungi situs TutuPP dan daftar cepat dengan kode verifikasi SMS.

2

Buat API Key

Di halaman «Kunci API» pada pusat akun, buat kunci dengan satu klik dan langsung pakai.

3

Kirim permintaan

Panggil REST API dengan API Key Anda, atau konfigurasikan di klien AI untuk memakai MCP.

Autentikasi

Semua permintaan API diautentikasi dengan menyertakan API Key di header HTTP.

Authorization: Bearer tk_YOUR_API_KEY

Base URL

https://tutupp.com

Format respons

Content-Type: application/json

Endpoint MCP

POST https://tutupp.com/api/mcp
Platform terbuka: setelah mendaftar, buat API Key tanpa persetujuan dan gunakan semua fitur API dan MCP seketika.

Integrasi MCP

MCP (Model Context Protocol) adalah protokol terbuka dari Anthropic yang memungkinkan asisten AI memanggil alat eksternal secara langsung.

Setelah dikonfigurasi, Anda dapat memakai bahasa alami agar AI menjalankan alur lengkap «unggah dokumen → buat pesanan → bayar dengan saldo».

Info protokol

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

Protokol：JSON-RPC 2.0 over Streamable HTTP

Metode：initialize · tools/list · tools/call

Unggah file：Mendukung ekstensi multipart/form-data (message part + file parts, tanpa base64, 100MB+) dan standar application/json

Pilih klien AI Anda 21

Claude Code — CLI terminal

Tambah (Add)

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

Tambahkan --scope user untuk global, --scope project hanya untuk proyek saat ini

Ganti kunci (Replace)

claude mcp remove tutupp && claude mcp add --transport http tutupp ...(kunci baru)

Hapus (Remove)

claude mcp remove tutupp

Contoh percakapan AI

Anda： Cetak report.pdf dari desktop saya, A4 hitam-putih, dan bayar dengan saldo saya

AI memanggil otomatis:

1. upload_document → Unggah file

2. get_print_prices → Cek harga A4 hitam-putih

3. create_order → Buat pesanan

4. pay_with_balance → Bayar dengan saldo

AI： Selesai! Pesanan PP2026040612345, A4 hitam-putih ×1, ¥0,50 dipotong dari saldo Anda.

Referensi REST API

Sebuah API Key dapat mengakses semua endpoint di bawah, mencakup semua fitur UI.

Manajemen dokumen

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

Manajemen foto

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

Pesanan

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

Pembayaran

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

Saldo

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

Kupon

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

Alamat pengiriman

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

Memesan untuk orang lain (pra-pesan)

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

Berbagi pra-pesan

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

Purnajual

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

Wilayah & pengiriman

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

Kueri konfigurasi

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

Pemulihan foto AI

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

Info pengguna

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

Status cetak

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

Kelola mandiri kunci API

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

Kesehatan sistem

GET /api/health

Daftar alat MCP69

Semua alat di bawah dapat dipanggil via protokol MCP; klien AI menemukannya otomatis setelah dikonfigurasi.

Manajemen dokumen

upload_document Unggah dokumen (PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX) — one of: file_url / content (base64) / file_path (curl)
list_documents Daftar semua dokumen yang diunggah pengguna saat ini
get_document_info Ambil detail dokumen (jumlah halaman, ukuran file, dll.)
delete_document Hapus dokumen (hanya jika tidak tertaut ke pesanan aktif)

Manajemen foto

upload_photo Unggah foto (JPG/PNG/WebP/HEIC) — one of: file_url / content (base64) / file_path (curl)
get_photo Ambil detail foto
delete_photo Hapus foto (hanya jika tidak tertaut ke pesanan aktif)
check_photo_quality Cek kualitas cetak foto pada ukuran tertentu (DPI)

Pesanan

create_order Buat pesanan cetak
list_orders Daftar semua pesanan pengguna saat ini
get_order_status Cek status dan detail pesanan
cancel_order Batalkan pesanan (hanya saat menunggu pembayaran)
track_order Cari info pesanan berdasarkan nomor (publik)
get_order_tracking Ambil info pelacakan kiriman pesanan

Pembayaran & saldo

create_payment Buat pembayaran pihak ketiga (mengembalikan payment_url, buka di browser untuk membayar)
pay_with_balance Bayar pesanan dengan saldo akun
get_payment_status Cek status pembayaran pesanan
create_topup Buat pesanan isi ulang saldo (mengembalikan payment_url)
get_balance Cek saldo akun (total/beku/tersedia)
get_balance_transactions Cek riwayat transaksi saldo

Kupon

list_coupons Daftar kupon pengguna saat ini
get_available_coupons Ambil kupon tersedia (filter berdasarkan jumlah)
redeem_coupon Klaim kupon lewat kode penukaran

Alamat pengiriman

list_addresses Daftar alamat pengiriman
create_address Tambah alamat pengiriman
update_address Perbarui alamat pengiriman
delete_address Hapus alamat pengiriman
parse_address Parsing teks alamat cerdas

Memesan untuk orang lain (pra-pesan)

list_pre_orders Daftar semua pra-pesan
create_pre_order Buat pra-pesan (bagikan tautan agar orang lain mengirim)
get_pre_order Ambil detail pra-pesan (termasuk semua kiriman)
update_pre_order Perbarui pengaturan pra-pesan
update_pre_order_status Ubah status pra-pesan
review_submission Tinjau kiriman pra-pesan
cancel_submission Batalkan suatu kiriman

Berbagi pra-pesan

get_share_info Ambil info tautan berbagi
submit_share_photos Kirim foto ke tautan berbagi
get_submission_status Cek status kiriman dan detail foto
list_my_submissions Daftar semua kiriman di sebuah tautan berbagi

Purnajual

list_after_sales Daftar catatan purnajual pengguna saat ini
create_after_sales Buat permintaan purnajual (refund/cetak ulang/kirim ulang)

Wilayah & pengiriman

list_regions Cek daftar wilayah
get_region Ambil detail wilayah dan sub-wilayah
get_region_tree Ambil pohon wilayah lengkap (provinsi → kota → distrik)
get_region_coverage Ambil statistik cakupan agen
get_city_coverage Ambil cakupan distrik dalam kota
get_agent_by_referral Cari agen berdasarkan kode referral
check_express_delivery Cek apakah pengiriman hari yang sama didukung
get_shipping_config Ambil konfigurasi pengiriman (global)
get_shipping_carriers Ambil daftar kurir (termasuk biaya daerah terpencil)
list_pickup_points Cek daftar titik ambil

Konfigurasi & status

get_print_prices Ambil harga cetak + tingkatan diskon volume
get_print_options Ambil ukuran dan jenis kertas tersedia
get_printer_status Cek status printer
get_queue_status Cek status antrean cetak

Info pengguna

get_profile Ambil profil pengguna saat ini
update_profile Perbarui nama panggilan pengguna

Pemulihan foto AI

restoration_preview Jalankan pratinjau pemulihan AI pada foto
get_restoration Ambil hasil tugas pemulihan AI

Kelola mandiri kunci API

list_api_keys Daftar semua API Key pengguna saat ini
create_api_key Buat API Key baru (kunci lengkap hanya ditampilkan sekali)
revoke_api_key Cabut API Key tertentu

Sistem

health_check Cek kesehatan layanan (basis data/gerbang pembayaran/versi)
get_auto_print_schedule Ambil pengaturan jendela waktu cetak otomatis

Ulasan pesanan

submit_order_review Kirim satu ulasan pesanan (rating 3 dimensi + komentar); idempoten via ON CONFLICT; batas 5/jam
batch_submit_order_reviews Ulasan massal (maks 20 · satu transaksi · atomik); 5 bintang sekali ketuk
list_my_order_reviews Daftar ulasan saya (amplop berpaginasi)
get_order_review Ambil detail satu ulasan (termasuk balasan resmi)
mark_order_review_read Tandai balasan resmi sebagai dibaca (CTE mencegah replay, mengurangi hitungan badge nav)

Contoh kode

Contoh lengkap alur «cek harga → unggah file → buat pesanan → bayar dengan saldo».

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

Alur kerja umum

Unggah file Cek harga Buat pesanan Bayar dengan saldo Selesai

Penanganan error

API menggunakan kode status HTTP standar; respons error berisi info error dalam JSON.

// Format respons error
{
  "error": "Deskripsi error"
}
400
Parameter permintaan salah Field wajib hilang, format salah
401
Belum terautentikasi API Key hilang atau tidak valid
403
Terlarang Operasi dilarang, izin kurang
404
Sumber daya tidak ada ID pesanan/dokumen/foto tidak ada
409
Konflik Foto tertaut ke pesanan, tak bisa dihapus
413
File terlalu besar Dokumen di atas 50MB / foto di atas 120MB
422
Aturan bisnis tak terpenuhi Saldo kurang, pesanan tak bisa dibatalkan
429
Terlalu banyak permintaan Melebihi batas laju API
500
Kesalahan server internal Coba lagi nanti atau hubungi dukungan
Pembatasan laju: hanya operasi tulis sensitif seperti login / daftar / kode verifikasi yang dilindungi dari serangan; penggunaan normal tidak pernah memicunya, dan ambang dapat dikonfigurasi di konsol admin. Respons membawa field retry_after_seconds + header Retry-After.

Siap memulai?

Daftar akun, buat API Key, dan biarkan AI menangani pencetakan Anda.

Daftar sekarang Kelola kunci API