واجهة التحقّق من الشهادات
تحقّق آليًّا من أيّ شهادة صادرة عبر AlgeriaCertify بطلب GET واحد، بلا مفتاح ولا تسجيل. الواجهة تُرجع ما تعرضه صفحة tkawen.com/verify العامّة فقط — لا بريد ولا هاتف ولا تاريخ ميلاد. الشهادة المُبطَلة تُرجع دائمًا valid:false.
نقطة النهاية
الرمز: من 4 إلى 64 خانة (حروف لاتينيّة وأرقام و-)، ولا يهمّ حجم الحروف. يُقبل رمز الشهادة (AC-2026-XXXXXX) أو رمز رابط التحقّق المطبوع في QR الشهادة.
# curl curl -s https://tkawen.com/api/v1/verify/AC-2026-RTLZEX // JavaScript (CORS: GET from any origin) const r = await fetch('https://tkawen.com/api/v1/verify/' + encodeURIComponent(code)); const data = await r.json(); if (data.valid) console.log(data.holder_display, data.title);
الاستجابة
صحيحة — 200
{
"valid": true,
"status": "valid",
"api_version": "1",
"code": "AC-2026-RTLZEX",
"holder_display": "…",
"title": "…",
"issuer": {
"name": "…",
"org_url": "https://tkawen.com/org/…"
},
"issued_at": "2026-09-30",
"expires_at": null,
"verify_url": "https://tkawen.com/verify?code=…",
"certificate_url": "https://algeriacertify.com/v/…",
"source": "AlgeriaCertify",
"checked_at": "2026-10-04T02:00:00+00:00"
}مُبطَلة — 200
{
"valid": false,
"status": "revoked",
"api_version": "1",
"code": "AC-2026-XXXXXX",
"verify_url": "https://tkawen.com/verify?code=…",
"source": "AlgeriaCertify",
"checked_at": "…"
}لا يُعاد نشر اسم صاحب شهادة مُبطَلة.
غير موجودة — 404
{
"valid": false,
"status": "not_found",
"api_version": "1",
"code": "AC-2026-XXXXXX",
"verify_url": "https://tkawen.com/verify?code=…",
"source": "AlgeriaCertify",
"checked_at": "…"
}الشهادة التي لم تُصدَر بعد (قيد المراجعة أو مرفوضة) تُعامَل كغير موجودة.
الحقول ورموز الحالة
| الحقل | الوصف |
|---|---|
valid | true فقط إذا كانت الشهادة صادرة وغير مُبطَلة. |
status | valid · revoked · not_found · invalid (رمز بصيغة خاطئة، HTTP 422) · unavailable (المصدر لا يستجيب، HTTP 503 — أعد المحاولة، ولا تعتبرها غير موجودة). |
holder_display | اسم صاحب الشهادة كما يظهر في صفحة التحقّق العامّة. |
title | التكوين أو التخصّص. |
issuer.name · issuer.org_url | الجهة المُصدِرة، ورابط صفحتها على TKAWEN إن وُجدت (وإلّا null). |
issued_at · expires_at | تاريخ الإصدار وتاريخ الانتهاء (YYYY-MM-DD أو null). |
verify_url | صفحة التحقّق البشريّة على tkawen.com — اعرضها للمستخدم. |
حدود الاستعمال والشروط
| البند | القيمة |
|---|---|
| حدّ المعدّل | 60 طلبًا في الدقيقة لكلّ عنوان IP — بعدها HTTP 429 مع Retry-After. |
| التخزين المؤقّت | Cache-Control: public, max-age=60 (و30 ثانية لغير الموجودة). |
| CORS | Access-Control-Allow-Origin: * لطلبات GET. |
| المصادقة | لا شيء — الواجهة عامّة وللقراءة فقط. |
الشروط: الواجهة للتحقّق من شهادة بعينها قدّمها لك صاحبها أو ظهرت في ملفّ (توظيف، قبول، شراكة). يُمنع الكشط الجماعيّ وتخمين الرموز وبناء قواعد بيانات من الاستجابات. نحتفظ بحقّ حجب أيّ عنوان يتجاوز ذلك. باستعمالها توافق على شروط الاستخدام وسياسة الخصوصيّة.
شارة «موثّقة على TKAWEN»
للمؤسّسات الموثّقة والمدرّبين المعتمدين: شارة SVG تُضمَّن في أيّ موقع وتقود إلى الصفحة الرسميّة على TKAWEN. لا تُصدَر إلّا لكيان موثّق فعلًا — غير ذلك يُرجع 404. أضف ?theme=dark للمواقع الداكنة.
<a href="https://tkawen.com/org/{slug}"><img src="https://tkawen.com/badge/org/{slug}.svg" alt="موثّقة على TKAWEN" height="48"></a>
<a href="https://tkawen.com/trainers/{code}"><img src="https://tkawen.com/badge/trainer/{code}.svg" alt="مدرّب موثّق على TKAWEN" height="48"></a>
مديرو المؤسّسة الموثّقة يجدون الرمز جاهزًا للنسخ في صفحة مؤسّستهم، والمدرّب في صفحته على سجلّ المدرّبين.
لوكلاء الذكاء الاصطناعيّ
بطاقة الوكيل /.well-known/agent.json تصف هذه الواجهة وبقيّة المهارات العامّة (البحث عن تكوين حسب الولاية، سجلّ المدرّبين، طلب أكاديميّة TKAWEN OS)، وبوّابة MCP تكشف التحقّق كأداة tkawen_verify.