REST API v1

Algeria Certify API

ادمج التحقق من الشهادات في أنظمتك

واجهة برمجة تطبيقات RESTful آمنة وسريعة لإصدار الشهادات والتحقق منها برمجيًا

ابدأ الآن
Base URL: https://api.algeriacertify.com/v1
1

البدء السريع

للبدء في استخدام واجهة البرمجة، تحتاج إلى مفتاح API يمكنك الحصول عليه من لوحة تحكم المؤسسة.

1
إنشاء حساب مؤسسة

سجّل كمؤسسة في /org واحصل على الموافقة.

2
الحصول على مفتاح API

من لوحة التحكم، انتقل إلى الإعدادات » API Keys وأنشئ مفتاحًا جديدًا.

3
ابدأ الاستدعاء

أرسل طلباتك إلى https://api.algeriacertify.com/v1

Authentication Header
Authorization: Bearer YOUR_API_KEY Content-Type: application/json Accept: application/json
2

التحقق من شهادة

GET /v1/certificates/{token}/verify

تحقق من صحة شهادة باستخدام رمز التحقق الفريد الخاص بها. يُرجع بيانات الشهادة كاملة مع حالة المصادقة ومؤشر الثقة.

cURL
$ curl -X GET "https://api.algeriacertify.com/v1/certificates/AC-2024-XXXX/verify" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Accept: application/json"
Response 200 OK
{ "status": "verified", "data": { "token": "AC-2024-XXXX", "holder_name": "محمد أمين بن علي", "certificate_type": "شهادة تكوين مهني", "institution": "المعهد الوطني للتكوين المهني", "issued_at": "2024-06-15", "expires_at": null, "blockchain_hash": "0x8a4f...e3b1", "trust_score": 92.5, "verification_count": 12 } }
3

إصدار شهادة

POST /v1/certificates

أصدر شهادة جديدة برمجيًا. يتطلب رصيدًا كافيًا في حساب المؤسسة. يتم تسجيل الشهادة تلقائيًا على البلوكتشين.

Request Body

cURL
$ curl -X POST "https://api.algeriacertify.com/v1/certificates" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "holder_name": "فاطمة الزهراء بوزيد", "holder_email": "fatima@example.com", "certificate_type": "شهادة إتمام دورة", "title": "دورة تطوير تطبيقات الويب", "issued_at": "2024-09-01", "expires_at": "2026-09-01", "metadata": {"hours": 120, "grade": "ممتاز"} }'

Response

Response 201 Created
{ "status": "created", "data": { "token": "AC-2024-7F3K", "holder_name": "فاطمة الزهراء بوزيد", "title": "دورة تطوير تطبيقات الويب", "verify_url": "https://algeriacertify.com/v/AC-2024-7F3K", "qr_code_url": "https://api.algeriacertify.com/v1/certificates/AC-2024-7F3K/qr", "blockchain_hash": "0x3c1a...f902", "credits_remaining": 47 } }
4

الأخطاء

تستخدم الواجهة أكواد حالة HTTP القياسية. في حالة الخطأ، يتضمن الرد رسالة توضيحية بالعربية.

الكود الحالة الوصف
401 Unauthorized مفتاح API غير صالح أو منتهي الصلاحية. تحقق من صحة المفتاح في رأس Authorization.
404 Not Found المورد المطلوب غير موجود. تأكد من صحة رمز الشهادة أو المسار.
422 Validation Error البيانات المرسلة غير صالحة. راجع حقل errors في الرد للتفاصيل.
429 Rate Limited تم تجاوز الحد الأقصى للطلبات (60 طلب/دقيقة). انتظر قبل إعادة المحاولة.
Error Response Example 422
{ "status": "error", "message": "بيانات غير صالحة", "errors": { "holder_name": ["حقل اسم الحامل مطلوب"], "certificate_type": ["حقل نوع الشهادة مطلوب"] } }
5

SDK JavaScript

أضف زر التحقق من الشهادات مباشرة في موقعك بسطرين فقط. يعمل مع أي إطار عمل أو موقع HTML عادي.

1. أضف السكريبت

HTML
<script src="https://cdn.algeriacertify.com/sdk/v1/verify.js"></script>

2. أضف زر التحقق

HTML
<div id="ac-verify-widget" data-api-key="YOUR_PUBLIC_KEY" data-theme="light" data-lang="ar"> </div>

3. التهيئة (اختياري)

JavaScript
AlgeriaCertify.init({ apiKey: "YOUR_PUBLIC_KEY", onVerified: function(result) { console.log("Certificate verified:", result.data.holder_name); }, onError: function(error) { console.error("Verification failed:", error.message); } });
6

Webhooks — إشعارات فورية

استقبل أحداث المنصة في نظامك فور وقوعها

عند تفعيل Webhook من لوحة التحكم → التكاملات، يُرسل طلب HTTP POST لكل حدث:

الحدث الوصف التوقيت
certificate.createdعند إصدار شهادة جديدةفوري
certificate.revokedعند إلغاء شهادةفوري
test.pingاختبار الاتصاليدوي

شكل الطلب المُرسل

Webhook Payload
{ "event": "certificate.created", "timestamp": "2026-03-17T14:30:00Z", "data": { "certificate_id": 42, "token": "ACVP-X5UP-845849", "course": "Full-Stack Development", "recipient_name": "أمينة بن علي", "recipient_email": "amina@example.com", "status": "active", "verify_url": "https://algeriacertify.com/v/ACVP-X5UP-845849" } }

التحقق من التوقيع (HMAC-SHA256)

Headers
X-AC-Event: certificate.created X-AC-Signature: sha256=abcdef1234567890... X-AC-Timestamp: 2026-03-17T14:30:00Z User-Agent: AlgeriaCertify-Webhook/2.0 // التحقق: hash_hmac('sha256', $body, $your_webhook_secret)
7

Zapier & n8n — أتمتة بدون كود

اربط Algeria Certify مع 5000+ تطبيق

Zapier

استخدم Triggers للاستماع للشهادات الجديدة، وActions لإصدار شهادات تلقائياً من Google Forms أو Typeform.

n8n

أضف رابط Webhook الخاص بـ n8n في صفحة التكاملات — كل حدث يُرسل تلقائياً.

نقاط الوصول — Zapier

الطريقة المسار الغرض
GET/api/v1/zapier/auth/testاختبار المصادقة
GET/api/v1/zapier/triggers/new-certificateTrigger — شهادة جديدة
GET/api/v1/zapier/triggers/revoked-certificateTrigger — شهادة ملغاة
POST/api/v1/zapier/actions/issue-certificateAction — إصدار شهادة
8

Open Badges 3.0 — معيار دولي

شارات رقمية متوافقة مع المعايير الدولية

كل شارة وشهادة تدعم معيار Open Badges 3.0 (JSON-LD) — يمكن التحقق منها عبر أي نظام متوافق عالمياً.

المسار الغرض
/api/v1/public/badges/assertions/{id}JSON-LD Assertion لشارة ممنوحة
/api/v1/public/badges/classes/{id}JSON-LD BadgeClass (تعريف الشارة)
مثال — Badge Assertion (JSON-LD)
{ "@context": "https://w3id.org/openbadges/v3", "type": "Assertion", "recipient": { "type": "email", "identity": "sha256$a1b2c3...", "hashed": true }, "badge": { "name": "شارة التميّز", "issuer": { "name": "أكاديمية TechBridge" } } }
9

مشاركة اجتماعية ذكية

صور ديناميكية لكل شهادة عند المشاركة

عند مشاركة رابط شهادة على LinkedIn أو Twitter أو Facebook، تظهر صورة ديناميكية احترافية (1200×630) مع اسم الطالب والدورة والمؤسسة.

المسار الغرض
/certificate/social/{token}صورة OG ديناميكية (1200×630 PNG)
/certificate/image/{token}صورة الشهادة عالية الدقة (PNG)
/v/{token}صفحة التحقق + Schema.org structured data
مجاني للبدء

احصل على مفتاح API مجانًا

سجّل كمؤسسة واحصل على 10 طلبات مجانية لاختبار الواجهة البرمجية

احصل على مفتاح API مجانًا
AC

ثبّت Algeria Certify

احتفظ بهويتك المهنية معك دائماً — إشعارات فورية وتجربة أسرع

Algeria Certify — منصة التوثيق الرقمي أنشئ ملفك مجاناً انضم كمؤسسة