> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# شارات قابلة للتضمين

> أضف شارات التحقق إلى موقع الويب الخاص بك، أو ملف README، أو محفظتك لإثبات أصالة المحتوى.

بعد حماية المحتوى على Truthlocks، يمكنك تضمين شارة ترتبط بالإثبات التشفيري. ينقر الزوار على الشارة للتحقق من الأصالة دون الحاجة إلى حساب Truthlocks.

## كيف تعمل الشارات

ينشئ كل حماية عنوان URL فريدًا للشارة وعنوان URL لصفحة الإثبات. الشارة هي صورة SVG ديناميكية تعرض حالة التحقق الحالية — **محمي** (سماوي/أخضر) أو **غير موجود** (أحمر). يؤدي النقر فوق الشارة إلى فتح صفحة الإثبات حيث يمكن لأي شخص فحص تفاصيل الإفادة.

تنسيق عنوان URL للشارة:

```text theme={null}
https://verify.truthlocks.com/api/badge/{attestation_id}
```

تنسيق عنوان URL لصفحة الإثبات:

```text theme={null}
https://verify.truthlocks.com/proof/{attestation_id}
```

## أنماط الشارات

تتوفر الشارات بأربعة أنماط. ألحق معلمة الاستعلام `style` لاختيار التخطيط:

| النمط | الوصف | الحجم |
| :- | :- | :- |
| **افتراضي** | شارة درع بلونين مع تراكب متدرج وزوايا مستديرة | 300 × 36 بكسل |
| **مسطح** | نفس التخطيط بلونين بدون تدرجات - نظيف وبسيط | 300 × 36 بكسل |
| **كبير** | شارة على شكل بطاقة تعرض حبة الحالة، وعنوان المحتوى، وتاريخ الحماية | 400 × 80 بكسل |
| **أدنى** | تسمية علامة اختيار نصية فقط بدون خلفية | 200 × 24 بكسل |

```text theme={null}
https://verify.truthlocks.com/api/badge/{attestation_id}?style=default
https://verify.truthlocks.com/api/badge/{attestation_id}?style=flat
https://verify.truthlocks.com/api/badge/{attestation_id}?style=large
https://verify.truthlocks.com/api/badge/{attestation_id}?style=minimal
```

### نسخة المظهر الداكن

يدعم كل نمط متغيرًا للسمة الداكنة. ألحق `theme=dark` لاستخدام خلفيات أفتح وألوان مميزة أكثر إشراقًا مناسبة للصفحات ذات الخلفية الداكنة:

```text theme={null}
https://verify.truthlocks.com/api/badge/{attestation_id}?style=flat&theme=dark
```

> [!TIP]
>
> استخدم نمط `large` على الصفحات المقصودة حيث تريد إبراز تاريخ الحماية وعنوان المحتوى. استخدم `minimal` للنص المضمن أو تذييلات ملف README حيث تكون المساحة محدودة.

## تنسيقات التضمين

بعد حماية المحتوى، انسخ رمز تضمين الشارة من صفحة الإثبات أو شاشة النجاح. يوفر Truthlocks تنسيقين:

```md Markdown theme={null}
[![Protected by Truthlocks](https://verify.truthlocks.com/api/badge/ATTESTATION_ID)](https://verify.truthlocks.com/proof/ATTESTATION_ID)
```

```html HTML theme={null}
<a href="https://verify.truthlocks.com/proof/ATTESTATION_ID">
  <img
    src="https://verify.truthlocks.com/api/badge/ATTESTATION_ID"
    alt="Protected by Truthlocks"
  />
</a>
```

استبدل `ATTESTATION_ID` بالمعرف الذي تم إرجاعه عند سك الحماية. لاستخدام نمط معين، أضف `?style=flat` (أو أي اسم نمط) إلى عنوان URL للشارة. أضف `&theme=dark` للصفحات الداكنة.

> [!TIP]
>
> في صفحة الحماية، انقر فوق **نسخ الشارة** بعد حماية المحتوى لنسخ
> رمز تضمين Markdown إلى حافظتك.

## الحالة الديناميكية

تعكس الشارات حالة التحقق في الوقت الفعلي للإشهاد الأساسي:

| الحالة | المظهر | المعنى |
| - | - | - |
| **محمي** | شارة سماوية/خضراء | الشهادة موجودة وصالحة في سجل الشفافية |
| **لم يتم العثور عليه** | شارة حمراء | لم يتم العثور على الشهادة أو تم إبطالها |

يتم تخزين استجابات الشارة مؤقتًا لمدة تصل إلى ساعة واحدة. إذا ألغيت إشهادًا، تتغير الشارة إلى "غير موجود" بعد انتهاء صلاحية ذاكرة التخزين المؤقت.

## الشهادات

يمكنك تنزيل شهادة SVG رسمية لأي حماية. تتميز الشهادة المعاد تصميمها بتصميم فاخر مع رأس متدرج داكن، وختم تحقق دائري، وزخارف زاوية، وبطاقة تفاصيل تعرض الفئة والتاريخ ومعرف التصديق والمصدر وتجزئة محتوى SHA-256.

```text theme={null}
GET /api/certificate/{attestation_id}              → SVG download
GET /api/certificate/{attestation_id}?format=html  → HTML view
```

يتم تنزيل إصدار SVG كملف (`truthlocks-certificate-{id}.svg`). يعرض إصدار HTML الشهادة في تخطيط صفحة مركزي مناسب للطباعة أو التضمين.

الشهادات مفيدة للأدلة القانونية، وعروض المحافظ، أو الطباعة. قم بتنزيلها من صفحة الإثبات أو شاشة نجاح الحماية.

## أين تستخدم الشارات

* **ملفات GitHub READMEs** - إثبات تأليف الكود مفتوح المصدر
* **المواقع الشخصية** — أظهر للزوار أن محتواك موثق
* **صفحات المحفظة** — اربط كل قطعة بدليلها التشفيري
* **سير ذاتية لوسائل التواصل الاجتماعي** — شارك عنوان URL لصفحة إثباتك مباشرة

## الخطوات التالية

> [card] [حماية المحتوى](https://docs.truthlocks.com/guides/content-protection.md)
>
> دليل كامل لحماية المحتوى بشهادات التشفير.

> [card] [محفظة عامة](https://docs.truthlocks.com/guides/portfolio.md)
>
> اعرض المحتوى المحمي الخاص بك على صفحة ملف شخصي عام.

> [card] [مواصفات حزمة الإثبات](https://docs.truthlocks.com/specification/proof-bundle.md)
>
> المواصفات الفنية لحمولة التحقق خلف كل شارة.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.