الانتقال إلى المحتوى الرئيسي
Certyneo
واجهة برمجة تطبيقات REST — eIDAS

واجهة برمجة التوقيع الإلكتروني للمطورين

تتيح واجهة API للتوقيع الإلكتروني لبرنامجك إرسال مستند للتوقيع، ومتابعة كل توقيع، واسترجاع ملف PDF الموقّع دون أي تدخل يدوي. وواجهة Certyneo هي REST API مع webhooks موقّعة بـ HMAC وتوقيع مدمج عبر iframe: مفاتيح اختبار مجانية، وبيئة الإنتاج مشمولة بدءاً من خطة قياسي بسعر 19 € شهرياً دون احتساب الضريبة.

تفضّلون التحكم بالإرسال من مساعد ذكاء اصطناعي؟ اكتشفوا الموصّل لـ ChatGPT وClaude.

مفاتيح اختبار مجانية · اتفاقية SLA بنسبة 99,9 % (Business و Enterprise) · استضافة داخل الاتحاد الأوروبي

REST + مواصفة OpenAPI

نقاط نهاية متوقعة، و JSON نظيف، ورموز HTTP قياسية. مواصفة OpenAPI قابلة للتنزيل لتوليد عملائك البرمجيين بنفسك.

مواقع ويب موثوق بها

5 محاولات بفواصل زمنية متزايدة، وتوقيع HMAC SHA-256، وإمكانية إعادة تشغيل الأحداث الفاشلة من لوحة التحكم. لا حاجة إلى برمجة الاستطلاع الدوري.

الامتثال الوطني لـ eIDAS

توقيع بسيط ومتقدم (رمز OTP عبر SMS) ومؤهل، يُختار لكل مظروف عبر الحقل signatureLevel. يُرفق سجل تدقيق مختوم زمنياً بكل مستند موقّع.

مستضافة داخل الاتحاد الأوروبي

خوادم في ألمانيا وفرنسا وإسبانيا. حدود معدل الطلبات منشورة لكل خطة، وترويسات X-RateLimit في كل استجابة. اتفاقية SLA بنسبة 99,9 % على خطتي Business و Enterprise.

كيف ترسل مستنداً للتوقيع عبر API؟

ارفع ملف PDF، وأنشئ المظروف، ثم أرسله: ثلاثة طلبات HTTP تكفي.

cURL — رفع، إنشاء، إرسال
# 1. Upload the PDF
curl https://certyneo.com/api/v1/documents \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -F "file=@contrat.pdf"
# → { "id": "cm8doc...", "status": "READY", ... }

# 2. Create the envelope (draft)
curl https://certyneo.com/api/v1/envelopes \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Contrat de prestation",
    "documentIds": ["cm8doc..."],
    "recipients": [{ "email": "client@example.com", "name": "Jane Doe" }]
  }'
# → { "id": "cm8env...", "status": "DRAFT", ... }

# 3. Send the invitations
curl -X POST https://certyneo.com/api/v1/envelopes/cm8env.../send \
  -H "Authorization: Bearer $CERTYNEO_API_KEY"

يُعيد POST /documents معرّف ملف PDF، وينشئ POST /envelopes مسودة مع الموقّعين، ثم يرسل POST /envelopes/:id/send الدعوات. بعد ذلك يصلك تقدّم العملية عبر webhook.

Node.js — دالة fetch الأصلية، دون أي تبعية
// Node 18+ — native fetch, no dependency
import { readFile } from "node:fs/promises";

const API = "https://certyneo.com/api/v1";
const auth = { Authorization: `Bearer ${process.env.CERTYNEO_API_KEY}` };

// 1. Upload the PDF
const form = new FormData();
const pdf = new Blob([await readFile("contrat.pdf")], { type: "application/pdf" });
form.append("file", pdf, "contrat.pdf");
const doc = await (await fetch(`${API}/documents`, { method: "POST", headers: auth, body: form })).json();

// 2. Create the envelope (draft)
const envelope = await (await fetch(`${API}/envelopes`, {
  method: "POST",
  headers: { ...auth, "Content-Type": "application/json" },
  body: JSON.stringify({
    subject: "Contrat de prestation",
    documentIds: [doc.id],
    recipients: [{ email: "client@example.com", name: "Jane Doe" }],
  }),
})).json();

// 3. Send the invitations
await fetch(`${API}/envelopes/${envelope.id}/send`, { method: "POST", headers: auth });

لا حاجة إلى أي SDK: تُستدعى الواجهة بدالة fetch الأصلية في Node 18 أو بأي عميل HTTP. كما تتيح مواصفة OpenAPI توليد عميل محدد الأنواع بلغتك البرمجية.

كيف تستقبل أحداث التوقيع عبر webhook؟

أحداث المغلف والمستقبل، توقيع HMAC قابل للتحقق والإعادة التلقائية.

envelope.completed
{
  "id": "cm8f2h6a10004qr9k5p2wm3xt",
  "event": "envelope.completed",
  "data": {
    "envelopeId": "cm7x2k9p40001qz8h3f7bn2ld",
    "subject": "Contrat de prestation",
    "status": "COMPLETED",
    "completedAt": "2026-09-26T08:42:13.000Z",
    "recipientCount": 1,
    "recipients": [
      { "email": "client@example.com", "name": "Jane Doe", "role": "SIGNER", "status": "SIGNED" }
    ],
    "signedDocumentUrl": "https://storage.certyneo.com/signed/...pdf?X-Amz-Expires=604800&..."
  },
  "timestamp": "2026-09-26T08:42:13.521Z"
}
  • توقيع HMAC SHA-256 لكل حمولة تحقق من صحة الجانب الخادم
  • إعادة محاولة تلقائية في حالة الفشل المؤقت: 5 محاولات على مدى حوالي 1 ساعة و 20 دقيقة مع تراجع أسي.
  • تُعرض الأحداث الفاشلة في لوحة التحكم ويمكن إعادة تشغيلها بنقرة واحدة. بعد 5 إخفاقات متتالية، تُعلَّق نقطة النهاية ويصلك إشعار بذلك.
  • حتى 5 نقاط نهاية في خطة Standard، و 15 في Business، و 50 في Business Pro، وكل منها مشترك في الأحداث التي تختارها.

وثائق الويب هوكس Certyneo

لماذا لدينا واجهة برمجة برمجة إلكترونية مخصصة للتوقيع الإلكتروني؟

إن دمج التوقيع الإلكتروني في منتجك ليس بالأمر الهيّن. فأنت بحاجة إلى ضمانات بشأن الامتثال القانوني (eIDAS)، والموثوقية التقنية (webhooks تصل فعلاً)، والتحكم في البيانات: Certyneo شركة خاضعة للقانون الفرنسي، وبياناتك تبقى داخل الاتحاد الأوروبي. وواجهة API من Certyneo تغطي الجوانب الثلاثة.

صُممت على يد مطورين ومن أجلهم، وتتبع أعراف REST: الإصدار في الرابط (/api/v1)، والترقيم عبر المعاملين page و limit، وأخطاء JSON برمز قابل للقراءة آلياً، ومواصفة OpenAPI لتوليد عملائك. لا SOAP، ولا XML، ولا مفاجآت.

أي مستوى توقيع eIDAS تختار عبر API؟

تحدد لائحة eIDAS ثلاثة مستويات للتوقيع: البسيط (SES) والمتقدم (AES) والمؤهل (QES). تتيح واجهة Certyneo اختيار مستوى كل مظروف عبر الحقل signatureLevel: القيمة SIMPLE (افتراضياً) أو ADVANCED أو QUALIFIED. يغطي التوقيع البسيط معظم العقود التجارية المعتادة؛ أما QES فيُستخدم حين يشترط نص قانوني أو مستلِم معادلته بالتوقيع اليدوي.

من الناحية التقنية، يُفعّل المستوى المتقدم تلقائياً رمز OTP عبر SMS ويطلب رقم هاتف لكل موقّع. يُختم سجل التدقيق زمنياً وفق معيار RFC 3161. ويستند QES إلى شهادة مؤهلة صادرة عن مقدّم خدمات ثقة مؤهل في الاتحاد الأوروبي. ويُدار كل ذلك عبر الواجهة البرمجية.

أي بنية تكامل تختار؟

النمط الأكثر شيوعاً للتكامل يتبع هذا التدفق:

  • يرفع الخادم الخلفي لديك ملف PDF (POST /api/v1/documents)، وينشئ المظروف كمسودة (POST /api/v1/envelopes)، ثم يرسله (POST /api/v1/envelopes/:id/send).
  • يتلقى الموقّع دعوته بالبريد الإلكتروني، أو يوقّع مباشرة داخل واجهتك بفضل التوقيع المدمج عبر iframe (POST /api/v1/envelopes/:id/embed-url، بدءاً من خطة Standard).
  • بعد أن يكتمل التوقيع، سيستدعي Certyneo شبكة الويب الخاصة بك مع حدث envelope.completed.
  • تقوم بتحديث قاعدة البيانات الخاصة بك وتعلم المستخدم (بإرسال البريد الإلكتروني، في التطبيق، وما إلى ذلك).

كيف تختبر API دون أن تدفع؟

مفاتيح sk_test_ متاحة في جميع الخطط، بما فيها خطة مجاني، ولا تستهلك مظاريف الاختبار حصتك الشهرية. في خطة مجاني، لا يمكن توجيهها إلا إلى عنوان بريدك الإلكتروني الخاص، وهي محدودة بـ 20 طلب في الساعة؛ أما الخطط التي تتيح API الإنتاج فترتفع من 200 إلى 1000 طلب في الساعة. تُحذف بيانات الاختبار بعد 30 يوماً. كما يفتح أول مفتاح اختبار في حساب مجاني خطة قياسي ليوم واحد.

هل يمكن دمج التوقيع دون كتابة أي شيفرة؟

كل ما تفعله هذه API يمكن التحكم فيه أيضاً بدون كتابة سطر واحد، من سير عمل: إنشاء ظرف، إرساله، الاستجابة لتوقيع، استرجاع ملف PDF المختوم ومسار تدقيقه. نفس الأساس، مع مصمّم بصري بدلاً من عميل HTTP. انظر تكامل Power Automate و Microsoft 365.

كيف تنقل تكاملاً مع DocuSign أو Yousign؟

إذا كان لديك تكامل قائم مع DocuSign أو Yousign، فالمصطلحات متقاربة: envelopes → envelopes، و recipients → recipients، و webhooks الخاصة بالحالة → webhooks. يشرح دليل الترحيل من DocuSign و Yousign إلى Certyneo الخطوات بالتفصيل، من تصدير القوالب حتى تحويل webhooks.

هل تهاجر من Adobe Acrobat Sign (سابقاً EchoSign، ثم Adobe Sign)؟ التعيين مباشر تماماً — agreements → envelopes، participants → recipients، webhooks → webhooks. مقارنة Certyneo و Adobe Acrobat Sign →

سعر API التوقيع الإلكتروني: أين تشتري اشتراكًا؟

لا حاجة إلى عرض سعر أو أمر شراء لشراء اشتراك في واجهة التوقيع البرمجية: مفاتيح الاختبار مجانية، ويُنشأ مفتاح API من لوحة التحكم، والوصول إلى REST API للإنتاج مشمول بدءاً من خطة Standard بسعر 19 €/شهر — مع webhooks، ودون رسوم على كل توقيع بسيط.

الخطط التي تتيح API الإنتاج (أسعار شهرية دون احتساب الضرائب، بلا التزام)
الخطةالسعر الشهري دون الضريبةالمظاريف شهرياًالطلبات في الدقيقة لكل مفتاحنقاط نهاية webhookالتوقيعات المؤهلة المشمولة شهرياً
قياسي‏19 €1006050
أعمال‏39 €300120151
بزنس برو‏99 €1,000300503

يُفوتر التوقيع المؤهل (QES) لكل عملية ويُدفع عند الإرسال: 9,90 € لكل توقيع مع اشتراك، تُخصم من البطاقة المسجّلة بعد استنفاد توقيعات QES المشمولة في Business و Business Pro، و 14,90 € دون اشتراك.

بالنسبة للأحجام الكبيرة أو في حالة الحاجة إلى التزام تعاقدي (SLA وDPA مخصص والفواتير السنوية)، يتم الاشتراك في خطة Enterprise من خلال فريق المبيعات. على أي حال، جميع الأسعار علنية — قارنها قبل الالتزام.

تفاصيل كل خطة موجودة في صفحة أسعار Certyneo؛ ولمعرفة موقع هذه الأسعار مقارنةً بالمزوّدين الآخرين، اطّلعوا على مقارنة أسعار التوقيع الإلكتروني.

للمزيد من المعرفة

السؤال API

ما هو الحد الأقصى لـ API؟

يُطبَّق الحد على كل مفتاح، في الدقيقة، حسب الخطة: 60 طلباً في Standard، و 120 في Business، و 300 في Business Pro، و 1 000 في Enterprise. تحمل كل استجابة الترويسات X-RateLimit-Limit و X-RateLimit-Remaining و X-RateLimit-Reset؛ وعند التجاوز تُعيد الواجهة الرمز 429 مع ترويسة Retry-After.

كم تكلفة الـ"API"؟

مفاتيح الاختبار (sk_test_) مجانية في جميع الخطط. الوصول إلى REST API للإنتاج مشمول بدءاً من خطة Standard بسعر 19 €/شهر (100 مظروف/شهر)، ثم Business بسعر 39 €/شهر و Business Pro بسعر 99 €/شهر بحصص متزايدة؛ ويُفوتر التوقيع المؤهل (QES) لكل عملية، 9,90 € مع اشتراك. للأحجام الأكبر، يُشترك في خطة Enterprise عبر فريق المبيعات.

هل هناك مرض من مرض التهاب الجلد؟

نعم: توافر شهري بنسبة 99,9 % على خطتي Business و Enterprise، مع رصيد على الفاتورة من 10 إلى 50 % حسب الفارق المُسجَّل. وتُنشر حالة الخدمة باستمرار على صفحة حالة Certyneo.

ما هو نوع التحقق الذي تستخدمه؟

مفتاح API في ترويسة Authorization (Bearer sk_live_… أو sk_test_…). تُنشأ المفاتيح وتُلغى من لوحة التحكم بأثر فوري.

كيف تتحقق من توقيع "إتش إم إك" على شبكة الإنترنت؟

يحمل كل webhook ترويسة التوقيع X-Certyneo-Signature: قيمة HMAC SHA-256 بالنظام الست عشري لجسم الطلب الخام، محسوبة بسرّ نقطة النهاية الخاصة بك. أعد حسابها على الخادم من الجسم غير المعدّل وقارن في زمن ثابت (crypto.timingSafeEqual في Node، و hmac.compare_digest في Python).

هل توجد SDK رسمية؟

لم تُنشر بعد. تُستدعى الواجهة مباشرة عبر HTTP من أي لغة برمجة، وتتيح مواصفة OpenAPI توليد عميل محدد الأنواع باستخدام openapi-generator أو أداة مماثلة. ومن دون كتابة شيفرة، تتوفر Certyneo أيضاً على Make و n8n و Postman و RapidAPI.

هل يمكنني الاختبار دون أن أدفع؟

نعم: أنشئ حساباً مجانياً وولّد مفتاح sk_test_ من لوحة التحكم. كما يمنح أول مفتاح اختبار في حساب مجاني يوماً من خطة Standard هدية. وتتيح مجموعة Postman تنفيذ الطلبات الأولى دون كتابة أي شيفرة.

كم تكلفة API EchoSign (التي أصبحت الآن Adobe Acrobat Sign)؟

استحوذت Adobe على EchoSign عام 2011، وأعادت تسميتها Adobe Sign ثم Adobe Acrobat Sign: لا تزال واجهتها البرمجية قائمة، لكن سعرها غير معلن ويمر عبر عرض سعر مؤسسي من فريق مبيعات Adobe، عادةً على شرائح من المعاملات السنوية. في المقابل، تعلن Certyneo أسعارها: الوصول إلى الواجهة البرمجية للإنتاج مشمول بدءاً من خطة Standard بسعر 19 €/شهر، يُشترك فيها عبر الإنترنت دون عرض سعر، مع مفاتيح اختبار مجانية لتقييم الواجهة قبل الدفع.

هل أنت مستعد لتضمين التوقيع الإلكتروني؟

مفاتيح اختبار مجانية، ومواصفة OpenAPI، و webhooks موقّعة. ابدأ الآن.