البدء السريع مع Python SDK

البدء السريع مع ⁨Python SDK⁩

ثبّت ⁨SDK⁩ الخاص بـ ⁨Python⁩ من فهرس حِزم ⁨Python⁩ ‏(⁨PyPI⁩):

pip install nextpdf

أنشئ عميلاً يتصل بنقطة نهاية ⁨NextPDF Connect⁩ لديك:

from nextpdf import NextPDF

client = NextPDF(base_url="http://localhost:8080", api_key="your-key")

with open("document.pdf", "rb") as file:
    blocks = client.ast.extract_cited_text(file.read())

for block in blocks:
    page = block.citation.page_index
    confidence = block.citation.confidence
    print(f"[page {page}, confidence {confidence:.2f}] {block.text[:100]}")

إذا لم تتطلب نقطة النهاية مفتاح ⁨API⁩، فاحذف api_key.

استخدام متغيرات البيئة

يمكن لواجهة سطر الأوامر (⁨CLI⁩) وتدفقات عمل الوكلاء قراءة إعدادات الاتصال من متغيرات البيئة:

export NEXTPDF_BASE_URL=http://localhost:8080
export NEXTPDF_API_KEY=your-key

في ⁨Windows PowerShell⁩:

$env:NEXTPDF_BASE_URL = "http://localhost:8080"
$env:NEXTPDF_API_KEY = "your-key"

معالجة الأخطاء الشائعة

التقط استثناءات ⁨SDK⁩ و⁨API⁩ عند استدعاء طرق الاستخراج:

from nextpdf import NextPDF
from nextpdf.models.errors import NextPDFAPIError, NextPDFError, QuotaExceededError

client = NextPDF(base_url="http://localhost:8080", api_key="your-key")

try:
    with open("document.pdf", "rb") as file:
        blocks = client.ast.extract_cited_text(file.read())
except QuotaExceededError as error:
    print(f"Rate limit hit: {error}")
except NextPDFAPIError as error:
    print(f"API error {error.status_code}: {error}")
except NextPDFError as error:
    print(f"SDK error: {error}")

لملفات ⁨PDF⁩ التي يزيد حجمها على 100 ⁨MB⁩، استخدم ⁨CLI.⁩ يتيح ذلك بثّ النتائج من دون تحميل كل كتلة مستخرجة إلى الذاكرة دفعة واحدة.