الفريق والإدارة
نقاط نهاية API
دع البرامج والنصوص البرمجية وعمليات الأتمتة ترسل المستندات إلى عنوان URL سري وتطبعها.
نقطة نهاية API هي عنوان URL سري ترسل إليه البرامج المستندات، مثل الفواتير من نظام ERP أو الملصقات من متجر إلكتروني أو التقارير من نص برمجي. يصبح كل مستند مهمة نيابةً عن الشخص الذي أنشأ نقطة النهاية، ويذهب إلى وجهة نقطة النهاية. عنوان URL نفسه هو مفتاح الوصول، لذلك لا يلزم رمز API. يصف مرجع API كل خيار.
المتطلبات المسبقة
- يجب أن تكون قناة الإدخال REST API مفعّلة ضمن الإعدادات ← قنوات الإدخال. وهي مفعّلة في المؤسسات الجديدة؛ وفي المؤسسات الأقدم قد يحتاج أحد المسؤولين إلى تفعيلها.
- يمكن لكل عضو إنشاء نقاط نهاية API. يرى المستخدمون نقاطهم الخاصة، ويرى المسؤولون جميع نقاط النهاية في المؤسسة.
- مضمّنة في كل خطة.
الإعداد لمرة واحدة
- انتقل إلى المصادر ← نقاط نهاية API واختر نقطة نهاية API جديدة.
- أدخل الاسم الذي يوضح الغرض من نقطة النهاية، مثلًا «فواتير ERP».
- اختر الهدف للمستندات التي لا يحدد طلبها هدفًا: وجهة أو مجموعة أو سير عمل، أو الهدف الافتراضي، أو بلا هدف – الاحتفاظ في Sealed Print.
- اختر إنشاء وانسخ عنوان URL لنقطة النهاية إلى برنامجك.
أرسل المستند كنص الطلب مع Content-Type مطابق:
curl -X POST "https://www.sealedprint.com/api/print/sp_ep_…?name=Invoice" \
-H "Content-Type: application/pdf" \
--data-binary @invoice.pdf
أو كنموذج يحتوي على الحقل file؛ وتُرسل الخيارات معه كحقول في النموذج:
curl -X POST "https://www.sealedprint.com/api/print/sp_ep_…" \
-F "file=@invoice.pdf" \
-F "name=Invoice" \
-F "copies=2"
يرسل targets طلبًا واحدًا إلى مكان آخر حسب المعرّف: معرّفات الوجهات أو المجموعات أو سير عمل، مفصولة بفواصل، مثلًا
targets=office,warehouse (يأتي سير العمل أولًا). وتفعل destinationId وdestinationIds وgroupId وworkflowId
الشيء نفسه حسب المعرّف الفريد (ID)، بينما يُبقي noTarget=true (أو targets=hold) المستند في Sealed Print. وهي تتجاوز
هدف نقطة النهاية لطلب واحد؛ أما خيارات الطباعة مثل copies أو sides فتُرسل كمعاملات استعلام أو حقول في النموذج.
الاستجابة هي المهمة (HTTP 201).
في كل مرة
- يُظهر آخر استخدام على نقطة النهاية ما إذا كان أحد البرامج لا يزال يرسل المستندات.
- يغيّر تعديل الاسم والهدف؛ ويبقى عنوان URL كما هو.
- يستبدل إنشاء عنوان URL جديد عنوان URL؛ ويتوقف العنوان القديم عن العمل فورًا. ينهي حذف نقطة النهاية نهائيًا.
- لمتابعة حالة مهمة من برنامجك، استخدم رمز API.
استكشاف الأخطاء وإصلاحها
- HTTP 403: قناة الإدخال REST API متوقفة، أو أن الشخص الذي أنشأ نقطة النهاية غادر المؤسسة. أنشئ نقطة نهاية جديدة بواسطة عضو آخر.
- HTTP 404: عنوان URL خاطئ أو استُبدل بعنوان جديد. مع الرمز
unknown_target، يكون أحد المعرّفات فيtargetsغير موجود أو يخص وجهة لا يستطيع مالك نقطة النهاية الطباعة إليها. - HTTP 413 أو 415: الملف أكبر مما تسمح به الخطة، أو ليس بصيغة PDF أو JPEG أو PNG.
- نُسخ عنوان URL إلى مكان لا ينبغي أن يكون فيه: اختر إنشاء عنوان URL جديد فورًا.
الخطوات التالية
- مرجع API: كل نقطة نهاية، مع وصف OpenAPI.
- رموز API
- قنوات الإدخال والإخراج
- طباعة مستندات Stripe: الفواتير والإشعارات الدائنة وعروض الأسعار من Stripe عبر نقطة نهاية API.