واجهة برمجة تطبيقات REST — eIDAS

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

قم بتكامل التوقيع الإلكتروني eIDAS في تطبيقك في غضون ساعات. REST، شبكات الويب الموثوق بها، Node/Python/Ruby SDK، صناديق الرمل المجانية غير المحدودة.

إنشاء حساب مطور وثائق API

ساندبوكس مجاني · 99.95٪ وقت تشغيل · استضافة ذات سيادة في الاتحاد الأوروبي

REST + OpenAPI 3.1

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

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

إعادة التحقق الآلي مع إعادة تأمين أساسية، توقيع HMAC SHA-256, سجل الأحداث قابل للتعقب.

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

AES، AES-Q و QES متاح عبر API flag. مسار تدقيق مؤهل مدرج، شهادات TSP مؤهلة من الاتحاد الأوروبي.

فترة تأخير < 200 ميس

API مستضافة في ستراسبورغ (الاتحاد الأوروبي) ، p95 < 200 ms من أوروبا.

ستبدأ في 5 دقائق

قم بإنشاء غلافك الأول باستخدام طلب HTTP واحد.

cURL إنشاء غلاف

curl https://api.certyneo.com/v1/envelopes \
  -H "Authorization: Bearer $CERTYNEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Contrat de prestation",
    "documents": [{"file_url": "https://your.app/contract.pdf"}],
    "recipients": [{"email": "client@example.com", "name": "Jane Doe"}],
    "webhook_url": "https://your.app/webhooks/sign"
  }'

طلب POST يكفي لإنشاء غلاف، وإضافة وثيقة، ووقيع، وURL webhook. يعيد API sign_url جاهز للمشاركة.

الـ SDK الرسمي لـ Node.js

import Certyneo from '@certyneo/sdk';

const client = new Certyneo({ apiKey: process.env.CERTYNEO_API_KEY });

const envelope = await client.envelopes.create({
  title: 'Contrat de prestation',
  documents: [{ file_url: 'https://your.app/contract.pdf' }],
  recipients: [{ email: 'client@example.com', name: 'Jane Doe' }],
});

console.log(envelope.sign_url); // ready to share with the signer

يوفر SDK Node TypeScript الطباعة الكاملة، وإدارة الأخطاء التلقائية مع التجربة، وبناء غلاف سائل. متوفر أيضًا في Python و Ruby.

شبكات الويب رد فعل في الوقت الحقيقي

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

envelope.completed

{
  "event": "envelope.completed",
  "envelope_id": "env_3a2f...",
  "signed_at": "2026-05-25T14:32:18Z",
  "evidence_url": "https://api.certyneo.com/v1/envelopes/env_3a2f.../audit-trail.pdf",
  "signers": [
    { "email": "client@example.com", "signed": true, "ip": "82.x.x.x" }
  ]
}

توقيع HMAC SHA-256 لكل حمولة تحقق من صحة الجانب الخادم
إعادة التجربة التلقائية في حالة الفشل: 5 محاولات في 24 ساعة مع احتياط إضافي.
سجل الأحداث يمكن الاطلاع عليه من لوحة التحكم: شاهد كل محاولة، حالة HTTP التي تم إرجاعها، الجسم.
عنوان URL لـ webhook يمكن تكوينه من خلال الغلاف أو العالمي في المشروع.

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

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

تم تصميمها من قبل المطورين وبالنسبة لهم، وهي تتبع اتفاقيات REST الحديثة: تصنيف صفحات على أساس المؤشر، مفاتيح الحد من عدم القدرة، نسخة URL، OpenAPI 3.1 لتوليد عملائك تلقائيًا. لا يوجد SOAP، لا يوجد XML، لا توجد مفاجآت.

تم توضيح امتثال eIDAS للمطورين

يحدد نظام eIDAS ثلاثة مستويات للتوقيع: بسيطة (SES) ، متقدمة (AES) ، ومؤهلة (QES). تسمح واجهة برمجة التطبيقات Certyneo باختيار المستوى من خلال الملف عبر حقل `signature_level`. القيمة الافتراضية هي AES (يكفي لـ 95% من الحالات B2B). يتوفر QES للأوراق التي تتطلب مساوية قانونية صارمة للتوقيع اليدوي (أوراق شهادة، العقود العامة).

من الناحية التقنية، يتطلب AES مصادقة قوية للموقع (OTP عن طريق الرسائل النصية الافتراضية، KYC الفيديو اختياري) ومسار تدقيق مؤشر الوقت. يضيف QES شهادة مؤهلة صادرة عن TSP مؤهلة في الاتحاد الأوروبي. يتم إدارة كل هذا بواسطة API تتصل بالمنطقة النهائية، ونحن نتولى الباقي.

معماري الاندماج الموصى به

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

يقوم الخلفي بكلام POST /v1/envelopes لإنشاء المظروف ويتلقى sign_url لتقديمه للمستخدم.
يمكنك إعادة توجيه المستخدم إلى sign_url أو تضمينها في iframe (مع علامتك التجارية عبر الخطة المهنية).
بعد أن يكتمل التوقيع، سيستدعي Certyneo شبكة الويب الخاصة بك مع حدث envelope.completed.
تقوم بتحديث قاعدة البيانات الخاصة بك وتعلم المستخدم (بإرسال البريد الإلكتروني، في التطبيق، وما إلى ذلك).

صندوق الرمل المجاني غير محدود

بيئة الصندوق مجانية وغير محدودة. جميع ميزات الإنتاج متاحة باستثناء أن التوقيعات لا قيمة قانونية لها (يتم وضع علامة على PDF SANDBOX). عملية للاختبارات الآلية ، والعروض التجريبية للعملاء ، والتنمية المحلية. مفاتيح الصندوق منفصلة عن مفاتيح الإنتاج ، والعزلة الكاملة بينهما.

وإذا كنت لا تريد كتابة أي كود

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

الهجرة من DocuSign أو Yousign

إذا كان لديك بالفعل تكامل DocuSign أو Yousign، فإن رسم الخرائط API هو مباشر: المظروفات → المظروفات، المستقبلين → المستقبلين، حالة webhooks → حالة webhooks. دليل الهجرة لدينا يوثق الموازين النهائية من نقطة إلى نقطة. توقع من 1 إلى 3 أيام للهجرة الكاملة، أقل بكثير إذا كنت تستخدم لف داخلي.

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

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

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

Standard — 19 €/شهر: 100 ظرف/شهر، API REST + webhooks، 10 مستخدمين
Business — 39 €/شهر: 300 ظرف/شهر، إرسال جماعي، نماذج ويب
Business Pro — 99 €/شهر: 1000 ظرف/شهر، API عالية التردد (300 طلب/دقيقة)، مستخدمون غير محدودين

التوقيع المتميز (QES) منتج مستقل، مدفوع على أساس كل عملية: 9,90 € لكل توقيع، متاح في جميع خطط الخدمات، بما في ذلك المجانية.

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

السؤال API

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

1000 طلب في الدقيقة تلقائيًا، يمكن زيادتها عند الطلب للاستخدامات العالية (المصانع، منصات متعددة المستثمرين). يشير عنوان X-RateLimit-Remaining على كل إجابة إلى الحد المتبقي. في حالة تجاوز، تعيد API 429 مع Retry-After.

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

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

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

99.95٪ من الوقت في خطط الأعمال والشركات (حد أقصى 4 ساعات من وقت الراحة في السنة). صفحة حالة عامة مع تاريخ الحوادث: status.certyneo.com. تشمل خطة Enterprise ائتمانًا تلقائيًا في حالة عدم الامتثال لـ SLA.

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

رمز الحامل (مفتاح API) في رأس الإذن. المفاتيح قابلة للتدوير من لوحة التحكم ، مع إلغاء فوري. لدمج OAuth (منصة متعددة الجهات) ، نقدم OAuth 2.0 Client Credentials على خطة المؤسسة.

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

يتضمن كل ويبهوك رأسًا X-Certyneo-Signature يحتوي على HMAC SHA-256 للحمولة، موقّعًا باستخدام سر الويبهوك الخاص بك. على جانب الخادم، أعد حساب HMAC وقارن النتائج في وقت ثابت (مقارنة آمنة من حيث التوقيت). يقوم SDK الرسمي بذلك تلقائيًا عبر webhook.verify(payload, signature, secret).

هل المجموعات التنموية مفتوحة المصدر؟

نعم. و SDK Node و Python و Ruby موجودة على GitHub بموجب ترخيص MIT. يمكنك التشغيل أو المساهمة أو مجرد تدقيقها. يتم نشر الثنائيات على npm و PyPI و RubyGems تحت مساحة الأسماء @certyneo / certyneo.

هل يمكنني أن أجرب بدون تسجيل؟

نعم، من خلال الأمثلة التفاعلية في وثائق API: /developers/playground. تتم استفساراتها ضد مثيل صناديق الرمل المشتركة، دون حاجة إلى مفتاح. للاستخدام الجاد، قم بإنشاء حساب مطور مجاني (صندوق غير محدود).

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

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

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

صندوق رمل مجاني غير محدود، وثائق كاملة، أدوات تطوير رسمية، ابدأ الآن

اقرأ الوثائق التحدث إلى مطور "سيرتينيو"