تتطوّر واجهة wthaiq البرمجية باستمرار دون أن تكسر تكاملك. نثبّت الإصدار بترويسة مؤرّخة Wthaiq-Version: 2026-07-01: التغييرات غير الكاسرة — كنقطة جديدة أو حقل اختياري أو نوع حدث — تُشحن باستمرار على إصدارك نفسه، بينما تُطرح التغييرات الكاسرة في إصدار مؤرّخ جديد لا يؤثّر عليك حتى تختار ترقيته بنفسك. هذه الصفحة توثّق كل تغيير بتاريخه ووسمه.
Wthaiq-Version: 2026-07-01
كل تغيير في السجل موسوم بلونه ونوعه، لتقرأ أثره على تكاملك في لمحة.
تُدرج كل الإصدارات التجريبية (beta) ثم الإصدار المستقر v1 بتواريخها ووسومها الدقيقة.
sk_live_/sk_test_. صار كل مفتاح سرّي بصيغة موحّدة sk_ + 40 محرفًا سداسي عشريًا، وهو حيّ منذ لحظة إنشائه — لا وضع اختبار منفصل، وحقل livemode يساوي true دائمًا.pk_ آمنة للكشف في المتصفّح: مقفولة على نطاقات محدّدة عبر allowed_origins، ومحدودة بمجموعة مسارات ثابتة (القوالب، طلبات التوقيع، الموقّعون، التدفّقات) مع منع الكتابة على القوالب/الموقّعين/التدفّقات.POST /v1/signature_requests بدورة الحياة الكاملة (draft ثم sent ثم completed) ونقاط send وcancel وreminders وdownload وcertificate.Wthaiq-Signature (HMAC-SHA256 بصيغة t=..,v1=..) مع نافذة تحمّل زمني 300 ثانية وإعادة محاولة تصاعدية حتى 24 ساعة.sk_live_ وsk_test_، وسرّ توقيع الويبهوك whsec_؛ وضع الاختبار لا يُرسل بريدًا حقيقيًا ولا يُصدر شهادات قانونية. ملاحظة (2026-07-26): نظام البيئتين هذا أُزيل لاحقًا — راجع أعلى السجل.@wthaiq/node وwthaiq (Python) وwthaiq/wthaiq-php — تثبّت ترويسة الإصدار افتراضيًا وتتبع SemVer.Wthaiq-Version: 2026-07-01 هو الإصدار المؤرّخ الافتراضي لكل الحسابات الجديدة، مع ترويسة Wthaiq-Request-Id في كل استجابة.whsec_ من لوحة التحكّم دون انقطاع الخدمة.GET /v1/templates وGET /v1/templates/{id} مع تعريف الحقول (key وlabel وtype وrequired).source.type = "template" مع تمرير قيم الحقول في signers[].fields.fields من جسم الطلب.GET /v1/verifications/{reference} (رموز WTQ- وWTH-) دون مصادقة، لفحص سلامة المستند وأطرافه.integrity بقيم intact وmodified وunknown في كائن verification، مع أسماء الأطراف مُقنّعة.verification.created إلى قائمة أحداث الـWebhooks.POST /v1/signers/{id}/signing_session تُصدر رابط/توكن توقيع قصير العمر للتضمين داخل تطبيقك بعلامتك.signing_url إلى كائن signer لدعم الصفحة المستضافة والمضمّنة عبر الحقل نفسه.expires_at وإبطالها فور اكتمال التوقيع أو رفضه.identity_verification ونقطة GET /v1/identity_verifications/{id} (مستند رسمي + مطابقة وجه حيّة).require_identity على مستوى الطلب والموقّع، وحدثا signer.otp_verified وsigner.identity_verified.legal_level = "aes" الذي يربط التوقيع بشخص حقيقي مؤكَّد قبل فتح صفحة التوقيع.pades-lt مع DSS/LTV (شهادات + OCSP + CRL مضمّنة) للحفظ طويل الأمد والتحقق دون اتصال بجهة الإصدار.format = "pades-lt" القيمة الافتراضية لطلبات المستوى aes بدلًا من pades-t.document.sealed يُطلَق عند دمج توقيع CMS/PAdES في ملف الـPDF النهائي.pades-t) لإثبات لحظة التوقيع إثباتًا مستقلًّا.{ error: { type, code, message, param, request_id } } مع رموز HTTP قياسية (400/401/402/409/422/429).Idempotency-Key على طلبات POST (تُخزَّن 24 ساعة) لجعل إعادة المحاولة آمنة.X-RateLimit-Limit وRemaining وReset، ورمز 429 مصحوبًا بـRetry-After./v1/preview لصالح الإصدار المؤرّخ الجديد؛ ستُزال النقطة في إصدار مؤرّخ لاحق.نتّبع إصدارًا مؤرّخًا (date-based versioning). إصدارك المثبّت لا يتغيّر سلوكه أبدًا بتغيير كاسر — أنت وحدك من يقرّر متى يرقّيه.
تتطلّب إصدارًا مؤرّخًا جديدًا
enum، أو إعادة تسميتها.string إلى integer).required) جديد إلى طلب قائم.تُشحن باستمرار على إصدارك نفسه
enum جديدة (عالِج القيم غير المعروفة بمرونة).Wthaiq-Deprecation على الاستجابات المعنيّة، ونُبقي السلوك القديم عاملًا مدة لا تقل عن 6 أشهر قبل إزالته في إصدار مؤرّخ جديد — كي يتّسع الوقت للترقية بأمان. ثبّت الإصدار بإرسال ترويسة Wthaiq-Version مع كل طلب. إن لم تُرسلها، يُستخدم آخر إصدار مؤرّخ مثبّت على حسابك (أو أحدث إصدار افتراضي). لا يتغيّر سلوك إصدارك المثبّت أبدًا بتغيير كاسر:
curl https://wthaiq.com/api/v1/signature_requests \
-H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Wthaiq-Version: 2026-07-01"
# الاستجابة تعيد الإصدار المستخدم فعليًّا في الترويسة:
# Wthaiq-Version: 2026-07-01
# Wthaiq-Request-Id: req_9f2a1cWthaiq-Version في بيئة الإنتاج. لا حاجة إلى ترقية دفعة واحدة — كل تكامل يرقّي على إيقاعه. ابدأ من الوثائق الكاملة للواجهة البرمجية، وثبّت إصدارك المؤرّخ، واشترك لتصلك كل التحديثات أولًا بأول.