İçeriğe atlayın
Genel bakış Genel bakış Haberler Haberler
Paylaş

Cookbook

Kopyalanabilir promptlar. Hazır API örnekleri.

Document AI, Data API'leri ve IDE iş akışları için 28 prompt — kopyalayın, yapıştırın, kodu alın.

PaperOffice llms.txt her modern LLM tarafından okunur: Claude, Cursor ve IDE'niz geri kalanını yazar.

28 hazır prompt Gerçek uç noktalar REST ve MCP

Entegrasyon

llms.txt'den Sürekli Entegrasyona

Üç Adım: Dokümantasyonu Bağlayın, Niyeti Belirtin, Kodu Alın.

  1. llms.txt'yi Ekleyin

    Claude, Cursor veya IDE'nize yapıştırın.

  2. Amaç belirtin

    Ne inşa edileceği — veya bu sayfadan bir istem.

  3. Kod yazdırın

    IDE, çalışan entegrasyonu sağlar.

Document AI

Belgeleri okuyun, kontrol edin, gönderin

İstemi kopyalayın, Claude veya Cursor'e yapıştırın — tamam.

IDP Fatura + AI-OCR + Sınırlayıcı Kutular

Belgedeki konum dahil fatura alanlarını çıkarın.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build me an invoice extractor that:
1. Uploads a PDF via POST /job/add/workflow (multipart, field file_1)
2. Uses idp_collection=invoice, processing_lane=instant (sync)
3. Reads every field from result.pages_idp[0].suggested_fields
   (keys like _supplier_name, _total_amount, _invoice_date)
   and the boxes from result.pages_aiocr.pages
4. Renders a verification view highlighting each value
   at its bounding box position

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

AI-OCR — Resim/PDF'den metin

POST /job/add/paperoffice_aiocr___generate ile tam metin (ocr_mode=complete).

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Write a minimal script that:
1. Sends an image or PDF to POST /job/add/paperoffice_aiocr___generate
   (multipart, field file_1)
2. Uses ocr_mode=complete and processing_lane=instant (sync)
3. Prints the extracted text from result ?? job_result (pages)

Modes: complete (+tables), grid (+bounding boxes), text (plain).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

AI PDF Bölme — Birleştirilmiş PDF'i ayırma

Belge sınırlarını algılayın ve tekil dosyaları adlandırın.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a splitter for large batch PDFs (up to 3000 pages):
1. POST /job/add/workflow with template=pdf_ai_split (multipart, field file)
2. naming_instruction=Dokumenttyp_Datum_Absender,
   locale=de_DE, processing_lane=instant
3. List every created document from the result
   (suggested filename + page range)

The AI detects document boundaries automatically.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Belge Gizleme — Kişisel verileri karartma

İsimleri, IBAN'ları ve adresleri algılayın ve düzenleyin.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt
Also use llms-full.txt for anonymize parameters (scenario, apply).

Build a GDPR anonymizer (preview → apply):
1. POST /job/add/workflow template=document_anonymize_preview (field file)
2. Set scenario=gdpr_auskunft (or externe_weitergabe / finanzdaten),
   redact_categories=all, optional whitelist / custom_redact
3. client_wait=false then poll GET /job/get/{job_id}
4. Show detected_pii.redact_box_ids + simplified_boxes
5. Apply: POST /job/add/paperoffice_dataripper___redact_image
   with files + bounding_boxes + redact_boxes from the preview
   (or MCP: po_anonymization_pii_detect → po_anonymization_redaction_apply
   with preview_job_id)
Optional one-shot: REST template=document_anonymize OR MCP po_anonymization_anonymize
  (no HITL; pass scenario/whitelist).
Redact Agent: POST /documents/redact-agent-run or MCP po_documents_redact_agent_run.

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Ses TTS — Metinden sese

voice=Nadja (ve diğerleri) ile senkron MP3.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a text-to-speech generator:
1. POST /job/add/paperoffice_voice___tts with text=..., voice=Nadja,
   output_format=mp3
2. output=url and processing_lane=instant for a synchronous audio link
3. Play or download the audio URL from result ?? job_result

Voices: Nadja, Thomas, Anna, Hans (DE) + 100+ more.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDP Sözleşme + AI-OCR + Bounding Kutuları

Sözleşme alanlarını belgedeki konumlarıyla birlikte çıkarın.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a contract extractor that:
1. Uploads a PDF via POST /job/add/workflow (multipart, field file_1)
2. Uses idp_collection=contract, processing_lane=instant (sync)
3. Reads parties, dates and notice period from
   result.pages_idp[0].suggested_fields (value + bounding box)
4. Renders a verification view with bounding boxes

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

E-İmza — İmza isteği oluşturma

İmzalayıcıları davet edin ve durumu/hatırlatıcıları yönetin.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an e-signature request flow:
1. Ensure the document has a pofid in PaperOffice
2. POST /signatures/create with document_pofid (or pofid)
   and a signers array (name + email per signer)
3. Return the signature request id and status
4. Optionally POST /signatures/remind for pending signers

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Dijital İhtarname — E-posta ile gönderin

PDF şifresi (e-posta veya SMS) ve gönderim protokolü ile güvenli teslimat.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a secure document delivery (digital registered mail):
1. POST /document_delivery/create_and_send with:
   pofids: ["POFID_HERE"],
   recipient_email, optional recipient_name,
   subject, optional message
2. security_mode=link → PDF password in the same email
   security_mode=secure_sms → link by email, password by SMS
   (requires recipient_phone in E.164, e.g. +49170…)
3. Show delivery_id and that access events are logged
   (Versandhistorie / delivery log)

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Veri & Güvenlik APIs

Konum, risk ve temel verileri kontrol edin

Coğrafi kodlama, hava durumu, parmak izi, KDV Vergi Numarası ve daha fazlası — prompt olarak.

Coğrafi Kodlama — İleri / Geri / Otomatik Tamamlama

Adres ↔ Koordinatlar.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a geocoding helper that:
1. Forward: GET /geocoding/forward?q=...&lang=de
2. Reverse: GET /geocoding/reverse?lat=...&lon=...
3. Autocomplete: GET /geocoding/autocomplete?q=...
4. Prints display_name, lat, lon and credits_billed

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Hava Durumu — Anlık + Hava Kalitesi

Faturalandırma dahil anlık hava durumu.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a weather lookup that:
1. Calls GET /weather/current?lat=...&lon=...&lang=de
2. Shows temperature, condition text and air quality if present
3. Displays credits_billed from the response

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IP2Location — IP → Konum

IP'den konum, isteğe bağlı hava durumu.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an IP intelligence client that:
1. Calls GET /ip2location/full (empty ip = visitor IP)
2. Extracts country, city, geo_lat/lon, ISP
3. Optionally chains weather from the same response

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Cihaz Parmak İzi — Ziyaretçi Kimliği

Ziyaretçi Kimliği ve Güven Skoru.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a device fingerprint check that:
1. Collects client signals in the browser
2. POSTs to /fingerprint/identify
3. Returns visitor_id / confidence for fraud checks

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Sahte E-posta Algılayıcı — Geçici Kontrol

Geçici e-posta ve Risk Skoru.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an email risk checker that:
1. Validates an address via the Fake Email Detector endpoint
2. Flags disposable / role / invalid domains
3. Returns a clear allow/deny recommendation

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

VPN / Anonimlik Kontrolü

VPN, Proxy, Tor, Veri Merkezi.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a VPN/proxy detector that:
1. Calls GET /ip2location/vpn?ip=...
2. Normalizes is_vpn, is_proxy, is_tor, is_datacenter flags
3. Shows a clear risk badge for the visitor

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

KDV Doğrulayıcı — AB Vergi Kimlik No.

Geçerlilik ve Firma Bilgileri.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a VAT ID validator that:
1. Checks an EU VAT number via the VAT validator endpoint
2. Returns company name and address when valid
3. Handles invalid / not-found responses cleanly

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Para Birimi Dönüşümü — Canlı Kur

Güncel kur ile dönüşüm.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a currency converter that:
1. Calls the currency exchange endpoint (from, to, amount)
2. Shows rate and converted amount
3. Caches the last rate for the UI

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDE & AI Araçları

Claude, Cursor ve IDE'niz için

IDE'de çalışan prompt'lar — MCP sunucusu dahil.

IDP Fatura Pipeline + Bounding Boxes + CSV

Doğrulama koordinatlarıyla toplu çıkarma.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a Python script that:
1. Takes a folder of invoice PDFs
2. Extracts all fields using POST /job/add/workflow with idp_collection=invoice
3. Returns bounding boxes for verification (result.pages_aiocr)
4. Exports to CSV

Important: Use file_1 for uploads; fields live in result.pages_idp[0].suggested_fields.
Handle sync (HTTP 200 with result) and async (HTTP 202 → poll GET /job/get/{job_id}).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

MCP Sunucusu — IDE'de Belge AI

MCP'yi bağlayın ve çalışma alanından belgeleri işleyin.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Help me set up the MCP Server for PaperOffice in Cursor.
I want to use Document AI directly in my IDE.

Show me:
1. How to configure the MCP connection (URL https://mcp.paperoffice.ai/cursor)
2. Available tools via tools/list
3. How to process documents from my workspace

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Sesli Aracı — STT + TTS

Sesli girişi işleyin ve sesli yanıtlar oluşturun.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a voice agent that:
1. Takes audio input (Speech-to-Text)
2. Processes the text
3. Generates audio response (Text-to-Speech)

Use these pipelines:
- STT: POST /job/add/paperoffice_voice___stt (audio_file)
- TTS: POST /job/add/paperoffice_voice___tts (text, voice=Nadja,
  output_format=mp3, output=url)
- Use processing_lane=instant for a synchronous response.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Sahtekarlık Tespiti — Parmak İzi + IP

Cihaz parmak izi ve Geo/IP sinyallerini doğrulayın.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a fraud detection system that:
1. Checks device fingerprints
2. Validates IP geolocation
3. Detects suspicious patterns

Use the Security & Data AI endpoints.
These are instant APIs (no polling needed).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Toplu AI PDF Bölme

Büyük PDF dosyalarını içeren klasörleri eşzamansız olarak bölün.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Create a batch processor that:
1. Takes a folder of large PDFs (up to 3000 pages each)
2. Uses POST /job/add/workflow with template=pdf_ai_split
3. Uses naming_instruction for smart filenames
4. Handles async jobs (HTTP 202) by polling GET /job/get/{job_id}

Use locale=de_DE for German document types.
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Belge Sınıflandırıcı — OCR + Klasör

OCR uygulayın, sınıflandırın ve alt klasörlere ayırın.

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a document classifier that:
1. Watches a folder for new PDFs
2. Uses OCR (POST /job/add/paperoffice_aiocr___generate, ocr_mode=complete)
   to extract text
3. Classifies into: invoice, contract, receipt, correspondence
4. Moves files to category subfolders
5. Logs results to classification_log.csv

Authenticate with: Authorization: Bearer po_ut_YOUR_API_KEY.
processing_lane=instant for a synchronous response.

Uçtan Uca

Tamamıyle Pipelines

Girişten ihracata — her aşama aynı prompt içinde.

IDP Faturalar → Muhasebe Dışa Aktarma

PDF Yükleme → AI-IDP + Sınır Kutuları → Doğrulama → CSV Dışa Aktarma

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build an accounts-payable pipeline:
1. Watch a folder for incoming invoice PDFs
2. Extract fields via POST /job/add/workflow (file_1,
   idp_collection=invoice, processing_lane=instant)
3. Flag every field with confidence < 0.9 for manual review,
   including its bounding box for the verification UI
   (result.pages_idp[0].suggested_fields + result.pages_aiocr)
4. Export supplier, total, date and IBAN as CSV for the accounting import

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

IDP Sözleşmeler + Son Tarih Uyarıları

Sözleşme Yükleme → Anahtar Kelimeler → Knowledge Graph → Uyarı Mesajları

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a contract analyzer:
1. Upload contracts via POST /job/add/workflow (file_1,
   idp_collection=contract, processing_lane=instant)
2. Extract parties, start date, end date and notice period
   from result.pages_idp[0].suggested_fields (each with a bounding box)
3. Store the key terms in a knowledge graph
4. Alert me 90 days before a notice period expires

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

PDF Dönüştürücü — Word / PowerPoint / PDF/A

PDF Yükleme → Format Seçimi → Dönüştürme → İndirme

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a PDF converter service:
1. One pipeline per target format (field file_1):
   POST /job/add/pdfstudio___pdf_to_word | pdfstudio___pdf_to_powerpoint |
   pdfstudio___pdf_to_pdfa | pdfstudio___pdf_to_webp
2. processing_lane=instant for a synchronous response
3. Return the download URL from result ?? job_result

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Webhooks — job.completed işlemini yönetme

Webhook Kaydı → Belge Gönderme → Olay Alma → İşleme

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a webhook event handler:
1. Register a webhook via POST /webhooks/subscribe
   (url, events: ["job.completed", "job.failed"], secret)
2. Verify the HMAC-SHA256 signature of every delivery
   with the subscription secret (see llms-full.txt, webhooks)
3. Process the payload whenever job.completed arrives

Note: webhooks always require a token (account binding).
Auth: Authorization: Bearer po_ut_YOUR_API_KEY

OCR → TTS — Belgeden Sese

Belge OCR → Metni hazırlayın → TTS oluşturun → Ses dosyasını kaydedin

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a document-to-audio pipeline:
1. OCR via POST /job/add/paperoffice_aiocr___generate
   (file_1, ocr_mode=complete, processing_lane=instant)
2. Split the extracted text (result ?? job_result, pages) into 5000-character chunks
3. TTS per chunk: POST /job/add/paperoffice_voice___tts (text, voice=Nadja,
   output_format=mp3, output=url, processing_lane=instant)
4. Save all returned audio URLs as a playlist

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Toplu OCR → CSV Dışa Aktarma

Klasörü tarayın → Toplu OCR → Metni toplayın → CSV dışa aktarın

İstem
Read this llms.txt (AI-optimized API docs):
https://api.paperoffice.ai/latest/docs/llms.txt

Build a batch OCR-to-CSV exporter:
1. Scan a folder for PDF/PNG/JPG/TIFF/WEBP files
2. For each file: POST /job/add/paperoffice_aiocr___generate
   (file_1, ocr_mode=complete, processing_lane=instant)
3. Collect filename, page_count, text preview and confidence
4. Write everything to ocr_results.csv

Auth: Authorization: Bearer po_ut_YOUR_API_KEY

Sonraki Adım

API ile devam edin

llms.txt ve Playground — dolandırıcı olmadan.

REST ve MCP için bir token credits_billed ile yanıtla Kendi AB altyapısı
Video

Cookbook Eylemde

PaperOffice API'ün uygulamada nasıl çalıştığını videoda izleyin.

Cookbook Eylemde

Sıkça Sorulan Sorular

Önemli Tüm Bilgiler Bir Arada

Bir SDK'ya ihtiyacım var mı?

Hayır. PaperOffice API saf REST'tir: bir uç nokta, bir Bearer token, multipart/form-data. IDE'ler ve ajanlar için ek olarak MCP sunucusu da mevcuttur.

Neden llms.txt her istemde yer alıyor?

llms.txt, API belgelendirmesinin makine tarafından okunabilir halidir. Modeliniz buradan uç noktaları, parametreleri ve yanıt formatlarını okur; alanlar uydurmaz.

Hangi anahtarı girmeliyim?

po_ut_ önekli bir Kullanıcı Token'ı girin. Bunu PaperOffice uygulamasında Hesap → API altında bulabilirsiniz. İstemdeki po_ut_YOUR_API_KEY ifadesini kendi anahtarınızla değiştirin.

Sonuç anında mı gelir yoksa polling yapmam mı gerekir?

processing_lane=instant ile API senkron yanıt verir (HTTP 200 ve result). Bu parametre olmadan HTTP 202 ve job_id gelir; sonucu GET /job/get/{job_id} veya webhook üzerinden alırsınız.

İstemler her ortamda çalışır mı?

İstemlerde araçlara özgü talimatlar yoktur. Claude, Claude Kodu ve Cursor ile test edilmiştir; URL okuyabilen her ortam bununla başa çıkar.

Bir çağrı ne kadar tutar?

Her yanıt credits_billed bilgisi içerir. Her borç hattı için kredi fiyatları fiyat listesindedir; yalnızca gerçekten işlenen miktar faturalandırılır.

PaperOffice’i nerede denemek istersiniz?

Bilgisayar ve akıllı telefon bağlı: Bilgisayarda çalışma alanı, telefonda yakalama.

Deneme sürümünüz hazır

Nerede başlamak istersiniz?

Tam çalışma alanı bilgisayar için optimize edilmiştir. Mobil sürüm belgeleri yakalamak, incelemek ve onaylamak için uygundur.

app.paperoffice.ai

Bilgisayarda başla

Kişisel erişim bağlantısını e-posta adresinize göndereceğiz.

PaperOffice Mobile'ı aç

Belgeleri doğrudan akıllı telefonla yakalayın ve düzenleyin.

Mobil sürümü aç
Ücretsiz kayıt Uygulamayı aç PaperOffice uygulaması Tam ürün: web, masaüstü ve mobil. Belgeleri yakalayın, düzenleyin, arayın ve ekibinizle üzerinde çalışın. Ücretsiz hesap gereklidir Playground’ı aç Playground Seçili işlevleri hemen deneyin — kayıt olmadan, kısıtlı bir demo API anahtarıyla. Kayıt yok, ancak kısıtlı bir demo API anahtarı