مرجع API
صورة QR للتذكرة
يعيد صورة PNG ذات علامة بحجم محدود لاعتماد التذكرة؛ ولا يمنح عرضها ملكية التذكرة.
GET
https://api.sparkglim.net/api/public/qr/ticket/:codeنموذج الوصول
- نموذج الوصول
- وصول عام مع تحقق
- التوفر الموثّق
- منفذ في المصدر
التوفر موثق من المصدر وليس ضمانًا لتشغيل الإنتاج.
استجابة PNG ثنائية وليست JSON، وعرض رمز لا يمنح صلاحية تسجيل الدخول.
المعاملات
| الاسم | النوع | التحقق من المدخلات |
|---|---|---|
codeمطلوباعتماد المورد أو رمز التحقق المطلوب للمسار؛ لا تنشر OTP حقيقيًا أو سر تذكرة. | string | التحقق: UUID أو معرّف مورد موثّق. |
sizeاختياريعرض صورة QR المطلوب والمقيد بمحرك العرض القائم. | integer | التحقق: 128–1024؛ القيمة الافتراضية: 512. |
الطلب
تصف الأمثلة العقد ولا تُنفذ. استخدم سجلات اختبار مصرحًا بها، ولا تلصق أسرارًا حقيقية في هذه الصفحات.
http
GET /api/public/qr/ticket/EXAMPLE_TICKET_CREDENTIAL?size=512 HTTP/1.1
Host: api.sparkglim.netالاستجابة
text
<binary PNG bytes>json
{
"success": false,
"error": "<ERROR_MESSAGE>"
}تستخدم أخطاء التحقق والصلاحيات والموارد والأعطال حالة HTTP وبنية الخطأ الخاصة بالمعالج.
الحدود وإعادة المحاولة
الحد الافتراضي: 100 طلب لكل عنوان IP خلال 60 ثانية، مع ضوابط إضافية حسب المورد.
توافق المصدر
تتطلب العمليات المصرح بها اختبارًا خاصًا بالحساب.
server/src/api/routes/public.tsapp/api/qr/ticket/[code]/route.ts