واجهة مساري للمطورين

GET https://masari-ai.com/api/certificate/{id}/verify.json
GET https://masari-ai.com/api/verify?code=MSR-XXXX-XXXXXX

يرجع حالة الشهادة واسم الحامل والجهة وتاريخ الإصدار ورمز التحقق. شارة مفتوحة بصيغة Open Badges: /api/certificate/{id}/openbadge.json.

GET https://masari-ai.com/api/registry/certificates?institute={instituteId}&since=2026-01-01

قائمة مختصرة بلا بيانات شخصية حساسة، للأنظمة التي تريد المطابقة الجماعية.

أنشئ مفتاحًا من إعدادات المعهد (صلاحية قراءة الشهادات، ينتهي بعد ٩٠ يومًا).

GET https://masari-ai.com/api/v1/certificates?since=2026-10-01&courseId=...
Authorization: Bearer msk_...

{ "ok": true, "count": 2, "certificates": [ { "id": "...", "serial": "...", "verifyCode": "MSR-...", "recipientName": "...", "courseTitle": "...", "issuedAt": "...", "verifyUrl": "..." } ] }

ضع رابط https في إعدادات المعهد؛ نرسل POST عند كل حدث مع توقيع HMAC-SHA256 للجسم في الرأس X-Masari-Signature.

POST {your-url}
X-Masari-Event: certificate.issued
X-Masari-Signature: <hex hmac sha256 of body>

{ "event": "certificate.issued", "at": "2026-10-19T10:00:00Z", "instituteId": "...", "data": { "certificateId": "...", "verifyCode": "MSR-...", "recipientName": "...", "recipientEmail": "...", "courseId": "...", "courseTitle": "..." } }

الأحداث: lead.created (تسجيل جديد: الاسم، البريد، الجوال، الدورة)، attendance.recorded، certificate.issued، test.

ملف تقويم لأي دورة: /api/course/{courseId}/ics · رمز الدورة: /api/course/{courseId}/qr · صفحة تضمين: /embed/{courseId}.

الحد العام ٦٠ طلبًا في الدقيقة لكل عنوان. للأسئلة: صفحة الدعم.