PenTool UIتصفّح المكتبة

الواجهات الكاملة · واجهة برمجية

صفحة توثيق

شريط تنقّل ومحتوى وفهرس جانبي — عرض السطر محدود لأنّ النصّ يُقرأ لا يُملأ

افتحها في لسان جديد ↗
<div class="iface ifo">
  <div class="ifo-wrap">
    <aside class="ifo-nav">
      <div class="brand" data-ar="مِفتاح" data-en="Miftah">مِفتاح</div>
      <nav>
        <b data-ar="البداية" data-en="Getting started">البداية</b>
        <a href="#"><span data-ar="التنصيب" data-en="Install">التنصيب</span></a>
        <a href="#" aria-current="page"><span data-ar="المصادقة" data-en="Authentication">المصادقة</span></a>
        <a href="#"><span data-ar="أوّل طلب" data-en="First request">أوّل طلب</span></a>
        <b data-ar="المراجع" data-en="Reference">المراجع</b>
        <a href="#"><span data-ar="المستخدمون" data-en="Users">المستخدمون</span></a>
        <a href="#"><span data-ar="الفواتير" data-en="Invoices">الفواتير</span></a>
        <a href="#"><span data-ar="الأخطاء" data-en="Errors">الأخطاء</span></a>
      </nav>
    </aside>

    <main class="ifo-main">
      <header class="if-top">
        <span class="brand" data-ar="المصادقة" data-en="Authentication">المصادقة</span>
        <span class="grow"></span>
        <span class="ifo-ver num">v2.4</span>
      </header>

      <div class="ifo-body">
        <article class="ifo-doc">
          <h1 data-ar="المصادقة" data-en="Authentication">المصادقة</h1>
          <p data-ar="كل طلب يحتاج مفتاحًا في ترويسة Authorization. المفاتيح تبدأ بـ mk_ ولا تُرسَل في عنوان الرابط أبدًا — العناوين تُسجَّل في الوسطاء والسجلّات، فمفتاحٌ فيها مفتاحٌ مسرَّب."
             data-en="Every request needs a key in the Authorization header. Keys start with mk_ and are never sent in the URL — URLs are logged by proxies and servers, so a key there is a leaked key.">كل طلب يحتاج مفتاحًا في ترويسة Authorization. المفاتيح تبدأ بـ mk_ ولا تُرسَل في عنوان الرابط أبدًا — العناوين تُسجَّل في الوسطاء والسجلّات، فمفتاحٌ فيها مفتاحٌ مسرَّب.</p>

          <h2 id="s1" data-ar="مثال" data-en="Example">مثال</h2>
          <pre dir="ltr"><code>curl https://api.miftah.dev/v2/users \
  -H "Authorization: Bearer mk_live_8f2c…"</code></pre>

          <div class="ifo-note">
            <b data-ar="لا تضع المفتاح في المتصفّح" data-en="Never ship a key to the browser">لا تضع المفتاح في المتصفّح</b>
            <span data-ar="كل ما يصل إلى صفحة الزائر يستطيع الزائر قراءته. النداءات من الخادم وحده."
                  data-en="Anything that reaches the visitor’s page can be read by the visitor. Call from your server only.">كل ما يصل إلى صفحة الزائر يستطيع الزائر قراءته. النداءات من الخادم وحده.</span>
          </div>

          <h2 id="s2" data-ar="انتهاء الصلاحية" data-en="Expiry">انتهاء الصلاحية</h2>
          <p data-ar="المفتاح لا ينتهي من تلقاء نفسه، ويُلغى فورًا حين تُلغيه من اللوحة. والإلغاء لا رجعة فيه."
             data-en="A key does not expire on its own, and is revoked the moment you revoke it from the dashboard. Revocation is final.">المفتاح لا ينتهي من تلقاء نفسه، ويُلغى فورًا حين تُلغيه من اللوحة. والإلغاء لا رجعة فيه.</p>
        </article>

        <nav class="ifo-toc" aria-label="في هذه الصفحة">
          <b data-ar="في هذه الصفحة" data-en="On this page">في هذه الصفحة</b>
          <a href="#s1"><span data-ar="مثال" data-en="Example">مثال</span></a>
          <a href="#s2"><span data-ar="انتهاء الصلاحية" data-en="Expiry">انتهاء الصلاحية</span></a>
        </nav>
      </div>
    </main>
  </div>
</div>
← لوحة تحكّم إداريةصندوق محادثات →